JM Boom

当前分支提供通过 Docker 部署的前后端分离项目。

Docker 部署

公开镜像：

ghcr.io/ppxb/jm-boom

直接使用 Docker 运行（请替换访问密码）：

docker run -d \
  --name jm-boom \
  --restart unless-stopped \
  --security-opt no-new-privileges:true \
  -p 3000:3000 \
  -v jm-boom-data:/app/data \
  -e JM_BOOM_ACCESS_PASSWORD="change-this-password" \
  ghcr.io/ppxb/jm-boom:latest

使用仓库中的 Compose 部署：

# 先编辑 docker-compose.yml 中的 JM_BOOM_ACCESS_PASSWORD
docker compose pull
docker compose up -d

默认访问地址：http://localhost:3000。

查看状态和日志：

docker compose ps
docker compose logs -f jm-boom

默认使用名为 jm-boom-data 的 Docker 命名卷持久化 SQLite、图片缓存和离线下载。升级或重建容器不会删除该命名卷。

升级：

docker compose pull
docker compose up -d

本地前端开发

使用 Node.js 24 和 pnpm（版本由 web/package.json 固定）：

corepack enable
cd web
pnpm install
pnpm dev

开发服务器将 /api 请求代理到 http://127.0.0.1:3000。类型、测试及构建验证使用 pnpm typecheck、pnpm test、pnpm lint、pnpm fmt:check、pnpm build。

运行时配置

• RUST_LOG：服务端日志过滤，默认 info,jm_boom_server=info。
• JM_BOOM_ACCESS_PASSWORD：进入 Web 界面前使用的轻量访问密码；部署前必须修改 Compose 中的默认值。
• JM_BOOM_CACHE_MAX_MB：封面与阅读图片共享的服务端缓存容量上限，单位 MB，默认 5120；达到上限后按 LRU 自动清理至容量的一半。
• JM_BOOM_CORS_ORIGINS：可选的逗号分隔跨域 Origin；同源部署不需要设置。

NSFW 警告

本软件可能存在裸露、暴力、色情或冒犯等不适宜公众场合的内容，请勿在公共场合使用本软件，避免不必要的纷争。

致谢

本项目参考了以下项目的部分实现，在此表示衷心的感谢！

• Breeze
• jmcomic-next

同时感谢社区 LinuxDO 的帮助。

免责声明

本项目仅供学习、研究和技术交流使用。项目作者与任何第三方服务、原始应用或内容提供方无关。 使用者应自行遵守当地法律法规以及相关服务条款。因使用本项目产生的任何法律、版权、账号、数据或财务风险均由使用者自行承担。

联系我们

Telegram

License

遵循 MIT 协议。