Miyabi

接入 115 网盘和 JavDB 的媒体库管理工具。

Docker 部署

公开镜像：

ghcr.io/ppxb/miyabi

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

docker run -d \
  --name miyabi \
  --restart unless-stopped \
  --security-opt no-new-privileges:true \
  -p 8080:8080 \
  -v miyabi-data:/app/data \
  -e MIYABI_ACCESS_PASSWORD='change-this-password' \
  ghcr.io/ppxb/miyabi:latest

启动后访问 http://<服务器IP>:8080。

查看日志：

docker logs -f miyabi

升级时先拉取新镜像，再停止并移除旧容器：

docker pull ghcr.io/ppxb/miyabi:latest
docker stop miyabi
docker rm miyabi

然后重新执行上方的 docker run 命令，沿用原访问密码和 miyabi-data 数据卷。

容器以 UID/GID 10001:10001 运行；如将命名卷改为主机目录挂载，需要让该用户能够写入目录。

健康检查通过 /app/miyabi healthcheck 读取启动配置并访问容器内的 /api/health，不受宿主机端口映射影响。通过启动参数 -listen 指定监听地址时，需同步设置 MIYABI_LISTEN，或为健康检查命令传入相同的参数。

启动配置

通过 MIYABI_ACCESS_PASSWORD 配置访问密码。未配置密码或将密码设为空时关闭门禁。强烈建议您开启门禁。

环境变量	用途	默认值
MIYABI_LISTEN	HTTP 监听地址	:8080
MIYABI_DATA_DIR	SQLite 与图片缓存目录	二进制为 ./data，容器为 /app/data
MIYABI_LOG_LEVEL	日志级别	info
MIYABI_PROXY	访问上游服务的 HTTP 代理	空
MIYABI_ACCESS_PASSWORD	Web 入口密码	空，关闭门禁

NSFW 警告

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

特别鸣谢

感谢 莫愁 的 token，感谢 老罗 的115账号。

致谢

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

• javdb-cli

同时感谢社区 LinuxDO 的帮助。

免责声明

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

License

遵循 MIT 协议。