dcchendockeruser/iso-hub repository overview

⁠ISO Hub · 网页版 Linux 发行版 ISO 自动更新器

ISO Hub 是一个带网页界面的 Docker 化 Linux 发行版 ISO 自动更新器，支持在网页上勾选发行版/版本进行实时下载与 SHA256 校验、自动抓取镜像站刷新最新版本元数据、订阅同步自动跟新版，并提供过期 ISO 可视化清理与 SMB/WebDAV 网络共享功能。

⁠功能

⁠快速开始

三种部署方式任选其一：

① 阿里云 ACR（国内推荐）：

mkdir iso-hub && cd iso-hub
curl -O https://raw.githubusercontent.com/DC1024/iso-hub/master/docker-compose.acr.yml
docker compose -f docker-compose.acr.yml up -d                    # 核心（必启）
docker compose -f docker-compose.acr.yml --profile share up -d    # + SMB/WebDAV 共享（可选）
docker compose -f docker-compose.acr.yml --profile bt up -d       # + 种子下载（可选）

② Docker Hub（海外）： 把上面命令换成 docker-compose.dockerhub.yml 即可。

③ 源码构建：

git clone https://github.com/DC1024/iso-hub.git && cd iso-hub
docker compose up -d --build

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

公网部署必做：在 compose 同目录建 .env 播种管理员，否则登录页会报「管理员账号未设置」
（防抢注设计：未播种时仅允许从服务器本机 127.0.0.1:8899 首次建号，
或走 SSH 隧道 ssh -L 8899:127.0.0.1:8899 <user>@<服务器IP>）：

cat > .env <<'EOF'
ISO_HUB_ADMIN_USER=admin
ISO_HUB_ADMIN_PASS=换成你的强密码
EOF
docker compose up -d   # 改 .env 后重启生效

首次登录后建议先点右上角「⤓ 抓取最新版本元数据」，把内置样例清单刷新为镜像站当前最新版本列表。

⁠界面导览

顶部共 5 个页签：

⁠常用操作

下载 ISO：镜像列表 → 勾选版本（可整组勾选）→「⬇ 下载所选」→ 顶部任务条实时显示进度/速率，日志面板滚动输出，下载完成后自动做 SHA256 校验。

自动跟新版（订阅同步）：订阅同步页 → 为发行版开启订阅、设保留版本数 → 「立即执行」或在设置里建定时任务。此后每次同步自动拉取最新 N 版并删除过期 ISO（🔒 锁定的文件不会被删）。

多镜像源策略：设置页可选「A 固定优先级」或「B 实测选最快」；镜像下载策略默认跟随设置优先级，也可通过列表每行的下拉框单独为某个版本指定镜像源。

共享给 PVE / Windows：启用 --profile share 后自动创建 SMB + WebDAV 只读共享（账号 iso / iso123）：

⁠配置参考

⁠环境变量

⁠数据目录

全部数据持久化在宿主机 ./data：

data/
├── distributions.json      # 发行版清单（元数据刷新生成）
├── custom_sources.json     # 自定义源（独立保存，不被刷新覆盖）
├── subscriptions.json      # 订阅配置
└── linux/                  # ISO 落盘目录：{类型}/{发行版}/{文件}
    ├── Ubuntu/ubuntu-26.04-live-server-amd64.iso
    └── Arch/archlinux-2026.09.01-x86_64.iso

⁠常用命令

docker compose logs -f iso-hub     # 看服务日志
docker compose restart iso-hub     # 重启
docker compose pull && docker compose up -d   # 升级到最新镜像

⁠常见问题

登录报「管理员账号未设置」？
.env 里没配 ISO_HUB_ADMIN_USER / ISO_HUB_ADMIN_PASS，配好后 docker compose up -d 重启。首次登录后可在「设置 → 修改密码」改密。

点「刷新列表」没反应？
多为未登录导致 401 被静默处理，先登录；仍有问题看 docker compose logs iso-hub。

国内拉不动 Docker Hub 镜像？
改用方式① 阿里云 ACR 源。

Compose 报 profiles 不支持？
在用 v1（docker-compose），升级 Docker 或安装 Compose v2 插件，统一用 docker compose。

想改 SMB 端口/账号？
.env 设 SAMBA_PORT / SAMBA_USER / SAMBA_PASS，或网页「设置 → 共享设置」改（改后 docker compose restart samba webdav 生效）。

删除文件被拒绝？
该文件被 🔒 锁定保护，先在列表里解锁；保护列表也可在「设置」里批量管理。

⁠开发

# 本地运行（Python 3.12+）
pip install -r web/requirements.txt -r iso_download/requirements.txt
python web/app.py                  # 开发模式
python -m waitress web.app:app     # 或 waitress 生产模式

# 测试与静态检查（提交前必跑）
python -m unittest discover -s tests -p "test_*.py"
python -m ruff check . --select=F
python -m bandit -r web iso_download scripts -ll

项目结构：

web/            # Flask 应用 + 单文件前端 (static/index.html)
iso_download/   # 上游 CLI 封装：多源下载、元数据解析、GPG/SHA256 校验
tests/          # unittest 回归测试
scripts/        # 辅助脚本

CI：push 到 master 自动跑 Lint & Security，并构建推送 Docker Hub 与阿里云 ACR 镜像。

⁠致谢与许可

• 上游核心能力来自 Sowevo/iso_download⁠（Mozilla Public License 2.0）
• 本项目同样以 MPL-2.0⁠ 开源
• 数据源：清华 TUNA、中科大、网易等公开镜像站，种子源为 DistroWatch