[{"_1":2,"_206":-5,"_207":-5},"loaderData",{"_3":4,"_18":19,"_25":26,"_179":180},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16,"_17":11},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","dockerRebrandTour","routes/_layout",{"_20":-5,"_21":22,"_23":11,"_24":22},"username","isAskGordonEnabled",true,"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,"_92":-5,"_93":94,"_166":-5,"_167":11,"_168":22,"_169":11,"_170":11,"_171":11,"_172":-5,"_173":11,"_174":-5,"_175":176,"_177":95,"_178":-7},"canonicalUrl","https://hub.docker.com/r/ericwang2006/ctfile-services/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","ericwang2006","reponame","ctfile-services","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_47":48,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":60,"_43":35,"_32":33,"_62":63,"_64":49,"_65":66,"_67":66,"_68":69,"_70":-5,"_71":72,"_73":74,"_75":11,"_76":33,"_77":78,"_83":11,"_84":85,"_89":33,"_90":91},"categories",[42],{"_43":44,"_45":46},"name","Networking","slug","networking","content_types",[49],"image","date_registered","2025-10-09T22:06:17.472782Z","description","使用此docker镜像可以搭建自己的城通网盘解析api服务器和面板","is_private","last_updated","2026-11-05T17:41:54.493237Z","last_modified","2026-11-05T05:28:11.656362Z","media_types",[61],"application/vnd.oci.image.index.v1+json","pull_count",3985,"repository_type","star_count",1,"status","status_description","active","source","collaborator_count",0,"full_description","[![ctfile-services Docker Stars](https://img.shields.io/docker/stars/ericwang2006/ctfile-services.svg)](https://hub.docker.com/r/ericwang2006/ctfile-services/)\n[![ctfile-services Docker Pulls](https://img.shields.io/docker/pulls/ericwang2006/ctfile-services.svg)](https://hub.docker.com/r/ericwang2006/ctfile-services/)\n\n# 城通网盘解析 API 服务器 + 面板（Docker）\n\n[Dockerfile](https://github.com/ericwang2006/docker_ctfile-downloader_with_panel)\n\n> **2026-11 更新**\n> 城通已停用旧的 `/p2` 客户端接口（返回 `410 请使用新客户端`），开放接口 `/v1` 又仅限 VIP 会员。\n> 本镜像已升级为**官方最新客户端 `/v4` REST 协议**，**普通免费账号可用**，同时保留 `/v1` 会员模式。\n>\n> - **免费账号**：启动后打开 `http://:8787/qr`，用手机 App 扫码一次，凭据会自动落盘并在后台静默续期。\n> - **VIP 会员**：仍可在 `SESSIONS` 环境变量中填写开放接口 session，走 `/v1`。\n\n---\n\n## docker-compose.yml\n\n```yaml\nservices:\n ctfile:\n image: ericwang2006/ctfile-services\n container_name: ctfile\n ports:\n - \"3000:3000\" # 解析面板\n - \"8787:8787\" # 解析 API\n environment:\n NEXT_PUBLIC_API_URL: http://localhost:8787\n PASSWORD: \"123456\"\n # 可选：启动时直接注入 refresh_token，多个用逗号分隔\n # REFRESH_TOKENS: \"token1,token2\"\n # 可选：VIP 会员的 v1 开放接口 session\n # SESSIONS: \"session1,session2\"\n volumes:\n # 【必须】持久化登录凭据，否则容器重启后需要重新扫码\n - ./data:/app/data\n restart: unless-stopped\n```\n\n> **重要**：数据目录固定为 `/app/data`（`DATA_DIR`）。\n> **不要**把卷挂载到 `/app/ctfile-downloader-node`，否则会覆盖程序代码。\n\n## .env\n\n```\nNEXT_PUBLIC_API_URL=http://localhost:8787\nPASSWORD=123456\n# REFRESH_TOKENS=token1,token2\n```\n\n## 环境变量\n\n| 变量 | 默认值 | 说明 |\n| --- | --- | --- |\n| `PASSWORD` | 空 | 访问密码。留空表示不校验。自动去除首尾空格与引号 |\n| `PORT` | `8787` | 解析 API 端口 |\n| `DATA_DIR` | `/app/data` | 数据目录，保存 `.tokens.json` 等凭据 |\n| `NEXT_PUBLIC_API_URL` | 自动推断 | 面板调用的 API 地址；留空时按当前访问地址推断 `:8787` |\n| `REFRESH_TOKENS` | 空 | 启动时注入的 refresh_token，逗号分隔（别名：`TOKENS`、`WEB_TOKENS`） |\n| `SESSIONS` | 空 | VIP 会员的 v1 开放接口 session，逗号分隔 |\n| `CTFILE_API_MODE` | `v4` | `v4` = 免费账号（默认）；`v1` = VIP 会员 |\n| `CTFILE_CARRIER` | `0` | 下载请求携带的运营商参数 |\n\n---\n\n## 添加账号（免会员，4 种方式任选）\n\n### 方式一：手机 App 扫码（推荐，最简单）\n\n1. 启动服务后，浏览器打开 `http://:8787/qr`\n2. 打开手机「城通网盘 App」，用扫一扫扫描页面上的二维码\n3. 在手机上点击「确认登录」，页面提示成功后账号自动加入账号池\n4. 可重复扫码添加多个免费账号，系统自动轮询下载以规避单账号限速\n\n### 方式二：扫码页手动粘贴 Token\n\n打开 `http://:8787/qr`，展开「没有 App？点这里粘贴 refresh_token」，\n粘贴 token 后点击「添加账号」。系统会自动校验并加入账号池，**无需重启容器**。\n\n### 方式三：HTTP 接口动态添加（适合脚本 / 自动化）\n\n```bash\n# token 字段会自动识别是 refresh_token 还是 access_token\ncurl -X POST http://localhost:8787/auth/token \\\n -H 'Content-Type: application/json' \\\n -d '{\"token\":\"你的_refresh_token\",\"username\":\"备注名\"}'\n\n# 也可以显式指定类型\ncurl -X POST http://localhost:8787/auth/token -d 'refresh_token=xxx'\ncurl -X POST http://localhost:8787/auth/token -d 'access_token=xxx'\n\n# 查看当前账号列表\ncurl http://localhost:8787/auth/accounts\n\n# 删除账号（按索引或 id）\ncurl -X POST http://localhost:8787/auth/accounts/delete -d 'index=0'\n```\n\n### 方式四：环境变量注入\n\n1. 浏览器登录城通网盘 \n2. 按 `F12` → Application → Session Storage，复制 `refresh_token` 的值\n3. 填入环境变量 `REFRESH_TOKENS`（多个用逗号分隔）后重启容器\n\n> `refresh_token` 在刷新时会被轮换。使用环境变量注入时，轮换后的新 token 会写入\n> `/app/data/.tokens.json`，且**优先于**环境变量。因此务必挂载 `/app/data`，\n> 否则容器重启后旧 token 已失效，需要重新扫码。\n\n---\n\n## API 使用\n\n### 换取下载直链（302 跳转）\n\n```bash\ncurl -i \"http://:8787/download?xtlink=&file_id=f1420878136&password=123456\"\n```\n\n- `xtlink`：分享链接中的 `xturl...` 串（也支持传入完整分享链接，服务端会自动提取）\n- `file_id`：文件 ID，**必须带 `f` 前缀**\n- `password`：`PASSWORD` 环境变量配置的访问密码\n- 成功时返回 `302`，`Location` 即真实直链，可直接交给 aria2 下载：\n\n```bash\naria2c \"$(curl -s -o /dev/null -w '%{redirect_url}' \\\n 'http://:8787/download?xtlink=&file_id=f1420878136&password=123456')\"\n```\n\n### 获取文件列表 / 下载信息\n\n```bash\ncurl \"http://:8787/download_info?xtlink=&password=123456\"\ncurl \"http://:8787/download_info?xtlink=&file_id=f1420878136&download=true&password=123456\"\n```\n\n### 校验访问密码\n\n```bash\ncurl \"http://:8787/login?password=123456\" # 返回 true / false\n```\n\n### 其他页面\n\n| 路径 | 用途 |\n| --- | --- |\n| `/meow` | 存活探针（返回 `Meow!`） |\n| `/config` | 查看当前运行配置（不含敏感信息） |\n| `/qr`、`/login/qr` | 扫码登录 / 手动添加 Token 页面 |\n| `/auth/accounts` | 账号池列表（JSON） |\n\n---\n\n## VIP 会员模式（可选）\n\n如拥有城通 VIP 会员：\n\n1. 登录城通网盘后台，进入「开放接口登录密钥管理」\n2. 生成 session，配置到环境变量 `SESSIONS`（多个逗号分隔）\n3. 设置 `CTFILE_API_MODE=v1` 后重启容器\n\n---\n\n## 构建与运行\n\n```bash\ndocker build -t ctfile-services .\nbash run.sh\n```\n\n`Dockerfile` 会从 GitHub clone 以下两个仓库，因此修改代码后需先 push：\n\n- `ericwang2006/ctfile-downloader-node`\n- `ericwang2006/ctfile-downloader-panel`\n\n### 快速启动\n\n```bash\ndocker run -d --name ctfile \\\n -p 8787:8787 -p 3000:3000 \\\n -e PASSWORD=123456 \\\n -v ./data:/app/data \\\n --restart unless-stopped \\\n ctfile-services:latest\n```\n\n## 解析面板\n\n\n\n面板会自动根据当前访问地址推断 API 地址（`<当前 host>:8787`），\n因此通过局域网 IP 或反向代理访问时无需手工修改 `NEXT_PUBLIC_API_URL`。\n\n---\n\n## v4 解析调用链（实测可用）\n\n1. `POST https://api.ctfile.com/v4/public/browser/list` — 浏览分享列表\n2. `POST https://api.ctfile.com/v4/public/browser/create-download-auth`\n - 请求：`{ \"xtlink\": \"\", \"ids\": \"f1420878136\" }`\n - 返回：`data.download_signature`\n3. （可选）`POST https://api.ctfile.com/v4/file/browse/download-audit` — 上报审计\n4. `POST https://api.ctfile.com/v4/public/browser/fetch-url`\n - 请求：`{ \"file_id\": \"1420878136\", \"download_sign\": \"\", \"xtlink\": \"\", \"carrier\": 0 }`\n - 返回：`data.download_url`（真实直链，302 后交给 aria2）\n\n> 换取直链必须用 **`/v4/public/browser/fetch-url`**，\n> 用 `/v4/file/browse/fetch-url-direct` 会对分享链接返回 `403 签名验证失败`。\n\n## 常见问题\n\n**Q：登录时提示 `该账号需要使用二维码登录` / `LOGIN_REQUIRE_QRSCAN`？**\n\n这是城通账号级的「登录保护」，与 UA、IP、客户端版本无关。即使密码正确，服务端\n也会要求扫码。手机 App 之所以能直接密码登录，是因为它持有本机已登记的设备凭据。\n\n处理方式：\n\n- 用 `/qr` 扫码一次，之后靠 refresh_token 自动续期（推荐）\n- 或从已登录设备导出 `refresh_token`，通过 `/auth/token` 导入\n- 或在网页端账号安全设置中关闭登录保护（如账号提供该开关）\n\n**Q：重启容器后又要重新扫码？**\n\n没有挂载 `/app/data`。`refresh_token` 轮换后的新值保存在那里，\n请务必加上 `-v ./data:/app/data`。\n\n**Q：`/download` 返回 `403 Wrong Password`？**\n\n`PASSWORD` 未正确传入，或请求参数中的密码与容器内配置不一致。\n注意 `PASSWORD` 会自动 trim 空格与引号。\n\n**Q：`/download` 返回 `502 No download_url returned`？**\n\n账号 token 已失效。访问 `/auth/accounts` 查看状态，必要时重新扫码或重新导入 token。\n","has_starred","hub_user","immutable_tags_settings",{"_79":11,"_80":81},"enabled","rules",[82],".*","is_automated","permissions",{"_86":22,"_87":11,"_88":11},"read","write","admin","user","storage_size",11584674079,"orgData","recentTags",[95],{"_96":49,"_97":98,"_99":100,"_101":102,"_103":104,"_105":106,"_55":154,"_155":98,"_156":33,"_157":61,"_43":158,"_159":160,"_161":162,"_163":154,"_164":69,"_165":22},"content_type","creator",4260905,"digest","sha256:3f096ed8a94e3f343d40fa9d0d4a0bb5904411e1df3abed7eb99ab50570920d4","full_size",63527172,"id",988665268,"images",[107,124,130,136,142,149],{"_108":109,"_99":110,"_111":112,"_113":114,"_115":116,"_117":118,"_119":112,"_120":-5,"_121":122,"_67":69,"_123":-5},"architecture","amd64","sha256:273cf63430144bff884d56751dbb6fed13b1f2fecc12dcf85b959f612ecdbaaf","features","","last_pulled","2026-11-05T17:40:18.162168524Z","last_pushed","2026-11-05T17:40:17.740830969Z","os","linux","os_features","os_version","size",68899065,"variant",{"_108":125,"_99":126,"_111":112,"_113":127,"_115":128,"_117":118,"_119":112,"_120":-5,"_121":129,"_67":69,"_123":-5},"ppc64le","sha256:4b6032f5d6e83e2fb33be20a057d3cbfc2722cb384e256c1a21863c80d772c3a","2026-11-05T17:41:26.022061652Z","2026-11-05T17:41:25.391351664Z",97279575,{"_108":131,"_99":132,"_111":112,"_113":133,"_115":134,"_117":118,"_119":112,"_120":-5,"_121":135,"_67":69,"_123":-5},"arm64","sha256:5eb65a53d1ebb605c348c710666da875477c470a214ca933a1708e22f9fc3c8c","2026-11-05T17:40:45.787498113Z","2026-11-05T17:40:45.143504372Z",68192712,{"_108":137,"_99":138,"_111":112,"_113":139,"_115":140,"_117":118,"_119":112,"_120":-5,"_121":141,"_67":69,"_123":-5},"s390x","sha256:9be68c66305cc3e28837e806bd8c753c467cde09bb797040b6b41d457b9f4410","2026-11-05T17:40:45.196496057Z","2026-11-05T17:40:44.661583986Z",68406507,{"_108":143,"_99":144,"_111":112,"_113":145,"_115":146,"_117":118,"_119":112,"_120":-5,"_121":147,"_67":69,"_123":148},"arm","sha256:7cf8ce1652119da6eca71a19e492cb0da4280a7638aa567ceb36ffb2cd9a8a8f","2026-11-05T17:40:36.388973451Z","2026-11-05T17:40:35.975654119Z",62655252,"v7",{"_108":143,"_99":150,"_111":112,"_113":151,"_115":152,"_117":118,"_119":112,"_120":-5,"_121":102,"_67":69,"_123":153},"sha256:1bdcafd2306f28f7795810d160ee8bf22545da05b4b4f20efe44a2189ef3e54b","2026-11-05T17:40:39.260882563Z","2026-11-05T17:40:38.316388578Z","v6","2026-11-05T17:41:53.422132Z","last_updater","last_updater_username","media_type","latest","repository",28797470,"tag_last_pulled","2026-11-05T17:41:53.841155475Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxAgenticPlatformBadge","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":181,"_189":190,"_175":204,"_205":11},{"_40":182,"_47":184,"_50":51,"_52":53,"_54":11,"_55":56,"_57":58,"_59":185,"_43":35,"_32":33,"_62":63,"_64":49,"_65":66,"_67":66,"_68":69,"_70":-5,"_71":72,"_73":74,"_75":11,"_76":33,"_77":186,"_83":11,"_84":188,"_89":33,"_90":91},[183],{"_43":44,"_45":46},[49],[61],{"_79":11,"_80":187},[82],{"_86":22,"_87":11,"_88":11},"tags",{"_191":66,"_192":-5,"_193":-5,"_194":195},"count","next","previous","results",[196],{"_96":49,"_97":98,"_99":100,"_101":102,"_103":104,"_105":197,"_55":154,"_155":98,"_156":33,"_157":61,"_43":158,"_159":160,"_161":162,"_163":154,"_164":69,"_165":22},[198,199,200,201,202,203],{"_108":109,"_99":110,"_111":112,"_113":114,"_115":116,"_117":118,"_119":112,"_120":-5,"_121":122,"_67":69,"_123":-5},{"_108":125,"_99":126,"_111":112,"_113":127,"_115":128,"_117":118,"_119":112,"_120":-5,"_121":129,"_67":69,"_123":-5},{"_108":131,"_99":132,"_111":112,"_113":133,"_115":134,"_117":118,"_119":112,"_120":-5,"_121":135,"_67":69,"_123":-5},{"_108":137,"_99":138,"_111":112,"_113":139,"_115":140,"_117":118,"_119":112,"_120":-5,"_121":141,"_67":69,"_123":-5},{"_108":143,"_99":144,"_111":112,"_113":145,"_115":146,"_117":118,"_119":112,"_120":-5,"_121":147,"_67":69,"_123":148},{"_108":143,"_99":150,"_111":112,"_113":151,"_115":152,"_117":118,"_119":112,"_120":-5,"_121":102,"_67":69,"_123":153},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
273cf6343014	linux/amd64	65.71 MB
1bdcafd2306f	linux/arm/v6	60.58 MB
7cf8ce165211	linux/arm/v7	59.75 MB

ericwang2006/ctfile-services

Tags for ericwang2006/ctfile-services