[{"_1":2,"_189":-5,"_190":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_162":163},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_151":-5,"_152":11,"_153":21,"_154":11,"_155":-5,"_156":11,"_157":-5,"_158":159,"_160":91,"_161":-7},"canonicalUrl","https://hub.docker.com/r/dcchendockeruser/iso-hub/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","dcchendockeruser","reponame","iso-hub","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":11,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2026-09-05T04:42:34.144871Z","description","","is_private","last_updated","2026-10-05T12:35:12.871801Z","last_modified","2026-10-05T12:16:25.24523Z","media_types",[56],"application/vnd.oci.image.index.v1+json","name","pull_count",8256,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# ISO Hub · 网页版 Linux 发行版 ISO 自动更新器\n\n> **项目源码：**
\n> **Docker Hub 镜像：**
\n> **GHCR 镜像：**`docker pull ghcr.io/dc1024/iso-hub`
\n> **阿里云 ACR 镜像（国内推荐）：** `registry.cn-hangzhou.aliyuncs.com/dcchen/isohub`\n\nISO Hub 是一个带网页界面的 Docker 化 Linux 发行版 ISO 自动更新器，支持在网页上勾选发行版/版本进行实时下载与 SHA256 校验、自动抓取镜像站刷新最新版本元数据、订阅同步自动跟新版，并提供过期 ISO 可视化清理与 SMB/WebDAV 网络共享功能。\n\n## 功能\n\n| 分组 | 能力 |\n|---|---|\n| **下载与校验** | 发行版/版本分组列表 · 勾选单个文件或整组下载 · 实时进度条与日志 · SHA256 自动校验 |\n| **多源容错** | 每个版本自动从多个镜像站下载，失败自动切换；全局支持「A 固定优先级」/「B 实测选最快」两种策略，也可逐行手动指定镜像源 |\n| **自动化** | 元数据自动刷新（抓镜像站目录写入清单）· **订阅同步**（自动拉最新 N 版 → 删除过期 ISO，内置定时调度）· 网页自建定时任务（每天/每周/每月/每年/一次性） |\n| **扩展来源** | **自定义源**：添加任意 ISO 直链或\"发行版源\"（按版本正则抓目录），独立保存不被刷新覆盖；**种子下载**：内置 DistroWatch 官方种子 RSS，支持手动粘贴磁力链接/自加 RSS 源，经内置 qBittorrent 下载后与直链统一管理 |\n| **管理** | 过期清理（标记+一键删除旧版）· 镜像保护 🔒（锁定文件清理/删除时被硬拒绝）· 筛选（全部/已下载/未下载/已收藏）· 单管理员登录（PBKDF2 加密 + 会话） |\n| **体验** | 日夜模式 · 中英双语（自动跟随系统）· 分组折叠 · SMB + WebDAV 网络共享（把 ISO 分享给 PVE/Windows 挂载） |\n\n## 快速开始\n\n三种部署方式任选其一：\n\n| 方式 | 适合场景 | 镜像来源 |\n|---|---|---|\n| **① 阿里云 ACR**（国内推荐） | 国内服务器，拉取快、公开仓库无需登录 | `registry.cn-hangzhou.aliyuncs.com/dcchen/isohub` |\n| **② Docker Hub** | 海外服务器 | `dcchendockeruser/iso-hub` |\n| **③ 源码构建** | 需要改代码 / 自定义 | 本地构建 |\n\n> **前置要求：Docker 20.10+ 与 Compose v2**（`docker compose`，带空格）。
\n> 本项目的 samba / webdav / qbittorrent 边车使用 compose **profiles** 管理，
\n> 旧版 `docker-compose`（v1，带连字符）不支持 profiles 且已 EOL，请勿使用。
\n> 验证：`docker compose version` 应输出 `v2.x.x`。
\n\n**① 阿里云 ACR（国内推荐）：**\n\n```bash\nmkdir iso-hub && cd iso-hub\ncurl -O https://raw.githubusercontent.com/DC1024/iso-hub/master/docker-compose.acr.yml\ndocker compose -f docker-compose.acr.yml up -d # 核心（必启）\ndocker compose -f docker-compose.acr.yml --profile share up -d # + SMB/WebDAV 共享（可选）\ndocker compose -f docker-compose.acr.yml --profile bt up -d # + 种子下载（可选）\n```\n\n**② Docker Hub（海外）：** 把上面命令换成 `docker-compose.dockerhub.yml` 即可。\n\n**③ 源码构建：**\n\n```bash\ngit clone https://github.com/DC1024/iso-hub.git && cd iso-hub\ndocker compose up -d --build\n```\n\n> **profiles 说明**：`up -d` 默认只启动核心（iso-hub + socket-proxy）。
\n> samba/webdav 归入`share` profile、qbittorrent 归入 `bt` profile，按需追加 `--profile` 启用；
\n> 未启用的服务不创建容器、不拉镜像。也可在 `.env` 里写 `COMPOSE_PROFILES=share,bt` 一劳永逸。
\n\n启动后访问 `http://<服务器IP>:8899`。\n\n**公网部署必做**：在 compose 同目录建 `.env` 播种管理员，否则登录页会报「管理员账号未设置」
\n（防抢注设计：未播种时仅允许从服务器本机 `127.0.0.1:8899` 首次建号，
\n或走 SSH 隧道 `ssh -L 8899:127.0.0.1:8899 @<服务器IP>`）：\n\n```bash\ncat > .env <<'EOF'\nISO_HUB_ADMIN_USER=admin\nISO_HUB_ADMIN_PASS=换成你的强密码\nEOF\ndocker compose up -d # 改 .env 后重启生效\n```\n\n首次登录后建议先点右上角「⤓ 抓取最新版本元数据」，把内置样例清单刷新为镜像站当前最新版本列表。\n\n## 界面导览\n\n顶部共 5 个页签：\n\n| 页签 | 用途 |\n|---|---|\n| 📦 镜像列表 | 主界面：按发行版分组浏览/勾选下载，查看本地状态（已下载/下载中/下载停止），删除、锁定、收藏 |\n| 🔗 自定义源 | 添加清单里没有的发行版：任意 ISO 直链，或\"发行版源\"（填目录地址+版本正则自动抓取），支持手动/定时刷新 |\n| ⭐ 订阅同步 | 为发行版开启订阅并设保留版本数 N，自动\"刷元数据 → 下最新 N 版 → 删过期\"；可立即执行或交给定时任务 |\n| 🧲 种子下载 | DistroWatch 官方种子 / 手动磁力链接 / 自定义 RSS 源，经内置 qBittorrent 下载（需 `--profile bt` 启用 sidecar） |\n| ⚙️ 设置 | 用户登录与改密、语言、共享开关（SMB/WebDAV）、定时任务、受保护列表、自定义源自动刷新 |\n\n## 常用操作\n\n**下载 ISO**：镜像列表 → 勾选版本（可整组勾选）→「⬇ 下载所选」→ 顶部任务条实时显示进度/速率，日志面板滚动输出，下载完成后自动做 SHA256 校验。\n\n**自动跟新版（订阅同步）**：订阅同步页 → 为发行版开启订阅、设保留版本数 → 「立即执行」或在设置里建定时任务。此后每次同步自动拉取最新 N 版并删除过期 ISO（🔒 锁定的文件不会被删）。\n\n**多镜像源策略**：设置页可选「A 固定优先级」或「B 实测选最快」；镜像下载策略默认跟随设置优先级，也可通过列表每行的下拉框单独为某个版本指定镜像源。\n\n**共享给 PVE / Windows**：启用 `--profile share` 后自动创建 SMB + WebDAV 只读共享（账号 `iso` / `iso123`）：\n\n| 协议 | 访问地址 | 说明 |\n|---|---|---|\n| SMB | `smb://<服务器IP>:1445/iso` | PVE：数据中心 → 存储 → 添加 SMB/CIFS，**端口填 1445** |\n| WebDAV | `http://<服务器IP>:8081/dav` | 任何 WebDAV 客户端 |\n\n> 端口 1445 是为避开 NAS 自带 Samba（445）的高位映射；无冲突的机器可在 `.env` 里 `SAMBA_PORT=445` 改回标准端口。账号密码可在「设置 → 共享设置」修改。\n\n## 配置参考\n\n### 环境变量\n\n| 变量 | 默认 | 说明 |\n|---|---|---|\n| `ISO_HUB_PORT` | `8899` | Web 端口（映射到容器 8080） |\n| `ISO_HUB_ADMIN_USER` / `ISO_HUB_ADMIN_PASS` | 空 | 管理员播种：用户表为空时自动创建；**公网部署必设** |\n| `ISO_HUB_REQUIRE_LOGIN` | `1` | `1`=强制登录才能使用；`0`=关闭门禁 |\n| `ISO_HUB_TOKEN` | 空 | 附加访问令牌（所有写操作需携带）；建议公网环境开启或置于反代之后 |\n| `ISO_HUB_SYNC_INTERVAL` | `86400` | 订阅自动同步间隔（秒）；`0`=关闭内置调度器 |\n| `SAMBA_PORT` | `1445` | SMB 映射端口（原 445） |\n| `SAMBA_USER` / `SAMBA_PASS` | `iso` / `iso123` | SMB 账号/密码 |\n| `WEBDAV_PORT` | `8081` | WebDAV 端口 |\n| `WEBDAV_USER` / `WEBDAV_PASS` | `iso` / `iso123` | WebDAV 账号/密码 |\n| `QB_PORT` | `8090` | qBittorrent WebUI 端口 |\n| `TZ` | `Asia/Shanghai` | 时区 |\n\n### 数据目录\n\n全部数据持久化在宿主机 `./data`：\n\n```\ndata/\n├── distributions.json # 发行版清单（元数据刷新生成）\n├── custom_sources.json # 自定义源（独立保存，不被刷新覆盖）\n├── subscriptions.json # 订阅配置\n└── linux/ # ISO 落盘目录：{类型}/{发行版}/{文件}\n ├── Ubuntu/ubuntu-26.04-live-server-amd64.iso\n └── Arch/archlinux-2026.09.01-x86_64.iso\n```\n\n### 常用命令\n\n```bash\ndocker compose logs -f iso-hub # 看服务日志\ndocker compose restart iso-hub # 重启\ndocker compose pull && docker compose up -d # 升级到最新镜像\n```\n\n## 常见问题\n\n**登录报「管理员账号未设置」？**
\n`.env` 里没配 `ISO_HUB_ADMIN_USER` / `ISO_HUB_ADMIN_PASS`，配好后 `docker compose up -d` 重启。首次登录后可在「设置 → 修改密码」改密。\n\n**点「刷新列表」没反应？**
\n多为未登录导致 401 被静默处理，先登录；仍有问题看 `docker compose logs iso-hub`。\n\n**国内拉不动 Docker Hub 镜像？**
\n改用方式① 阿里云 ACR 源。\n\n**Compose 报 `profiles` 不支持？**
\n在用 v1（`docker-compose`），升级 Docker 或安装 Compose v2 插件，统一用 `docker compose`。\n\n**想改 SMB 端口/账号？**
\n`.env` 设 `SAMBA_PORT` / `SAMBA_USER` / `SAMBA_PASS`，或网页「设置 → 共享设置」改（改后 `docker compose restart samba webdav` 生效）。\n\n**删除文件被拒绝？**
\n该文件被 🔒 锁定保护，先在列表里解锁；保护列表也可在「设置」里批量管理。\n\n## 开发\n\n```bash\n# 本地运行（Python 3.12+）\npip install -r web/requirements.txt -r iso_download/requirements.txt\npython web/app.py # 开发模式\npython -m waitress web.app:app # 或 waitress 生产模式\n\n# 测试与静态检查（提交前必跑）\npython -m unittest discover -s tests -p \"test_*.py\"\npython -m ruff check . --select=F\npython -m bandit -r web iso_download scripts -ll\n```\n\n项目结构：\n\n```\nweb/ # Flask 应用 + 单文件前端 (static/index.html)\niso_download/ # 上游 CLI 封装：多源下载、元数据解析、GPG/SHA256 校验\ntests/ # unittest 回归测试\nscripts/ # 辅助脚本\n```\n\nCI：push 到 `master` 自动跑 Lint & Security，并构建推送 Docker Hub 与阿里云 ACR 镜像。\n\n## 致谢与许可\n\n- 上游核心能力来自 [Sowevo/iso_download](https://github.com/Sowevo/iso_download)（Mozilla Public License 2.0）\n- 本项目同样以 [MPL-2.0](LICENSE) 开源\n- 数据源：清华 TUNA、中科大、网易等公开镜像站，种子源为 DistroWatch\n","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",839928002,"orgData","recentTags",[91,135],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":102,"_50":124,"_125":94,"_126":33,"_127":56,"_57":128,"_129":130,"_131":109,"_132":124,"_133":66,"_134":21},"content_type","creator",44425206,"digest","sha256:ed8daf4814bd709793bb516cbb540a648857a4aa3bf0015bc22bd2ead99b7686","full_size",61450493,"id",1296421646,"images",[103,118],{"_104":105,"_95":106,"_107":48,"_108":109,"_110":111,"_112":113,"_114":48,"_115":-5,"_116":98,"_63":66,"_117":-5},"architecture","amd64","sha256:2767a07d19d3bbd78cd3c1026cb1112706a173da86c85c50a5f93140a3c490b1","features","last_pulled","2026-10-05T21:33:54.541896631Z","last_pushed","2026-10-05T12:16:22.410965503Z","os","linux","os_features","os_version","size","variant",{"_104":119,"_95":120,"_107":48,"_108":121,"_110":122,"_112":113,"_114":48,"_115":-5,"_116":123,"_63":66,"_117":-5},"arm64","sha256:44ef88d17b1bb477ee10ba6d108a72946d185856ba74fe321922887e197fc34b","2026-10-05T13:04:36.359496754Z","2026-10-05T12:16:21.973590688Z",61895798,"2026-10-05T12:16:23.796413Z","last_updater","last_updater_username","media_type","latest","repository",32372781,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_92":44,"_93":94,"_95":136,"_97":137,"_99":138,"_101":139,"_50":149,"_125":94,"_126":33,"_127":56,"_57":150,"_129":130,"_131":142,"_132":149,"_133":66,"_134":21},"sha256:affe4a30f21ef89a0cbf8409f55413e4e5fd3d8c95a0e9392c8758246730b05b",61450502,1306059275,[140,144],{"_104":105,"_95":141,"_107":48,"_108":142,"_110":143,"_112":113,"_114":48,"_115":-5,"_116":137,"_63":66,"_117":-5},"sha256:538ae37f88afa2522166b24b8ea6b290c04a7533802810f4e1732e911ea3ea8a","2026-10-05T22:06:40.85760453Z","2026-10-05T12:35:10.783060542Z",{"_104":119,"_95":145,"_107":48,"_108":146,"_110":147,"_112":113,"_114":48,"_115":-5,"_116":148,"_63":66,"_117":-5},"sha256:4584ddf1485bbbee78a29f1fd38398318a79d8ff62e5614aeaed837ac10d2c34","2026-10-05T13:04:36.649445604Z","2026-10-05T12:35:10.189923506Z",61895780,"2026-10-05T12:35:12.313303Z","beta","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":164,"_171":172,"_158":187,"_188":11},{"_40":165,"_42":166,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":167,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":168,"_79":11,"_80":170,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":169},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_173":174,"_175":-5,"_176":-5,"_177":178},"count",2,"next","previous","results",[179,183],{"_92":44,"_93":94,"_95":136,"_97":137,"_99":138,"_101":180,"_50":149,"_125":94,"_126":33,"_127":56,"_57":150,"_129":130,"_131":142,"_132":149,"_133":66,"_134":21},[181,182],{"_104":105,"_95":141,"_107":48,"_108":142,"_110":143,"_112":113,"_114":48,"_115":-5,"_116":137,"_63":66,"_117":-5},{"_104":119,"_95":145,"_107":48,"_108":146,"_110":147,"_112":113,"_114":48,"_115":-5,"_116":148,"_63":66,"_117":-5},{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":184,"_50":124,"_125":94,"_126":33,"_127":56,"_57":128,"_129":130,"_131":109,"_132":124,"_133":66,"_134":21},[185,186],{"_104":105,"_95":106,"_107":48,"_108":109,"_110":111,"_112":113,"_114":48,"_115":-5,"_116":98,"_63":66,"_117":-5},{"_104":119,"_95":120,"_107":48,"_108":121,"_110":122,"_112":113,"_114":48,"_115":-5,"_116":123,"_63":66,"_117":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
538ae37f88af	linux/amd64	58.6 MB
4584ddf1485b	linux/arm64	59.03 MB

Digest	OS/ARCH	Compressed size
2767a07d19d3	linux/amd64	58.6 MB
44ef88d17b1b	linux/arm64	59.03 MB

dcchendockeruser/iso-hub

Tags for dcchendockeruser/iso-hub