MIXAPI Docker 镜像构建说明 - 海外版本
本目录包含在海外服务器上构建 MIXAPI Docker 镜像的相关文件,直连 GitHub 无需代理。
文件说明
| 文件 |
说明 |
Dockerfile |
Docker 镜像构建文件 |
common.sh |
公共函数库(变量定义、下载函数等) |
run.sh |
主启动脚本(构建时下载初始版本、运行时设置定时任务) |
check_update.sh |
更新检测脚本(由 crontab 定时调用) |
构建方法
# 进入海外版本目录
cd mixapi/overseas
# 构建镜像
docker build -t mixapi:latest .
# 多架构构建(需要 buildx)
docker buildx build --platform linux/amd64,linux/arm64 -t mixapi:latest --push .
运行方法
# 基本运行
docker run -d -p 3000:3000 mixapi:latest
# 挂载数据目录
docker run -d -p 3000:3000 -v /path/to/data:/data mixapi:latest
工作原理
构建时
- 使用
busybox:glibc 作为基础镜像(自带 wget、crond、sh)
- 复制脚本文件到
/app/ 目录
- 运行
run.sh OnlyUpdate 下载当前最新版本的 MIXAPI
运行时
- 设置 crontab 定时任务(每天执行一次更新检测)
- 启动 busybox crond 后台服务
- 后台执行一次更新检测
- 前台启动 MIXAPI 服务
定时更新
- 每天在容器启动时间的上一分钟执行更新检测
- 检测到新版本时自动下载并热更新
- 更新日志记录在
/app/update.log
网络配置
| 项目 |
配置 |
| GitHub API |
https://api.github.com/repos/aiprodcoder/MIXAPI/releases/latest |
| 文件下载 |
https://github.com/aiprodcoder/MIXAPI/releases/download/ |
支持架构
linux/amd64 (x86_64)
linux/arm64 (aarch64)
端口
数据目录
/data: 工作目录,建议挂载持久化存储
/app: 程序目录,包含可执行文件和脚本