[{"_1":2,"_196":-5,"_197":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_172":173},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_85":86,"_106":107,"_163":-5,"_164":11,"_165":17,"_166":11,"_167":-5,"_168":11,"_169":-5,"_170":171},"canonicalUrl","https://hub.docker.com/r/bitcometpostbar/bitcomet/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","bitcometpostbar","reponame","bitcomet","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":71,"_76":11,"_77":78,"_82":29,"_83":84},"categories",[],"content_types",[40],"image","date_registered","2025-02-04T14:33:41.476348Z","description","Docker Edition of BitComet Web UI by Post-Bar (unofficial mod)","is_private","last_updated","2025-04-19T14:13:23.033457Z","last_modified","2025-03-06T10:37:28.919362Z","media_types",[52],"application/vnd.oci.image.index.v1+json","name","pull_count",12112,"repository_type","star_count",3,"status",1,"status_description","active","source","collaborator_count",0,"full_description","# 介绍\n\nDocker Edition of BitComet Web UI by Post-Bar (unofficial mod)\n\n优化初始配置，并集成 STUN 穿透与 PeerBanHelper，STUN 穿透需要锥形 NAT 环境。\n\n　*欢迎移植其他下载器*\n\n## 快速使用\n\n**host 网络（传统模式）**\n\n```\ndocker run -d \\\n--name BitComet \\\n--net host \\\n-v /BC目录:/BitComet \\\n-v /DL目录:/Downloads \\\n-v /PBH目录:/PeerBanHelper \\\n-e BITCOMET_WEBUI_USERNAME='BC WebUI 用户名' \\\n-e BITCOMET_WEBUI_PASSWORD='BC WebUI 密码' \\\n-e BITCOMET_WEBUI_PORT='BC WebUI 端口' \\\n-e BITCOMET_BT_PORT=‘BC BT 端口’ \\\n-e PBH_WEBUI_TOKEN='PBH Token' \\\n-e PBH_WEBUI_PORT='PBH WebUI 端口' \\\nbitcometpostbar/bitcomet:latest\n```\n\n**host 网络（改包模式）**\n\n```\ndocker run -d \\\n--name BitComet \\\n--net host \\\n--cap-add NET_ADMIN \\\n-v /BC目录:/BitComet \\\n-v /DL目录:/Downloads \\\n-v /PBH目录:/PeerBanHelper \\\n-e BITCOMET_WEBUI_USERNAME='BC WebUI 用户名' \\\n-e BITCOMET_WEBUI_PASSWORD='BC WebUI 密码' \\\n-e BITCOMET_WEBUI_PORT='BC WebUI 端口' \\\n-e BITCOMET_BT_PORT=‘BC BT 端口’ \\\n-e PBH_WEBUI_TOKEN='PBH Token' \\\n-e PBH_WEBUI_PORT='PBH WebUI 端口' \\\nbitcometpostbar/bitcomet:latest\n```\n\n**bridge 网络（改包模式）**\n\n```\ndocker run -d \\\n--name BitComet \\\n--cap-add NET_ADMIN \\\n-p 56082:56082 \\\n-v /BC目录:/BitComet \\\n-v /DL目录:/Downloads \\\n-v /PBH目录:/PeerBanHelper \\\n-e BITCOMET_WEBUI_USERNAME='BC WebUI 用户名' \\\n-e BITCOMET_WEBUI_PASSWORD='BC WebUI 密码' \\\n-e BITCOMET_WEBUI_PORT='BC WebUI 端口' \\\n-e BITCOMET_BT_PORT=‘BC BT 端口’ \\\n-e PBH_WEBUI_TOKEN='PBH Token' \\\n-e PBH_WEBUI_PORT='PBH WebUI 端口' \\\nbitcometpostbar/bitcomet:latest\n```\n\n## 运行日志\n\n本镜像在启动以及 STUN 穿透通道发送变化时会输出重要的信息。\n\n可通过 `docker container logs BitComet` 或各 Docker 前端的日志功能查看。\n\n也可直接打开 `/BitComet/DockerLogs.log` 文件，内容与 Docker 日志同步。\n\n## 穿透模式\n\n本镜像提供两种穿透模式，分别称之为 **传统模式** 和 **改包模式**。\n\nBitTorrent 协议的特性上，需要向 Tracker 通告 NAPT 公网端口，其他 Peer 用户才能获取正确的信息并发起连接。\n\n而在 **运营商级 NAT** 下，内网端口与公网端口不一致且不固定，因此需要动态修改 BT 下载器向 Tracker 通告的端口。\n\n**传统模式** 的原理是获取 NAPT 公网端口后，修改为下载器的监听端口，以达到让下载器向 Tracker 通告公网端口的效果。**要求 Linux 内核 3.9 以上**。\n\n**改包模式** 的原理是获取 NAPT 公网端口后，通过防火墙框架 nftables 识别下载器的 Tracker 流量，并把通告端口篡改为公网端口。**要求 Linux 内核 3.13 以上**。\n\n目前支持 HTTP(S) 与 UDP Tracker 改包，WS(S) Tracker 尚未涉及。\n\n---\n\n**传统模式** 的穿透通道仅支持 TCP 或 UDP 二选一。因为 TCP 与 UDP 的公网端口也不一致，而通常下载器无法分别监听不同的端口号。\n\n**改包模式** 的穿透通道可 TCP 或 UDP 二选一，也可两者同时启用。TCP + UDP 模式下，nftables 会基于 Tracker 服务器的 IP 地址进行 50:50 负载均衡。\n\nnftables 进行 TCP + UDP 分流时，对同一 IP 地址的 Tracker 始终通告为 TCP 或 UDP 的公网端口，以免服务器侧的节点信息频繁变更。但**对于 HTTPS Tracker，由于使用了中间人攻击实现解密**，nftables 检测到的服务器地址始终为 `127.0.0.1`，因此对所有 HTTPS Tracker 都会通告同一个端口号。\n\n　*尚未确认具体会通告 TCP 还是 UDP*\n\n 基于 UDP 的 uTP 传输协议，通过 DHT 的 `implied_port` 及部分下载器实现的 PEX 端口替换，使其本身带有一定的穿透能力，无论传统模式还是改包模式都不会影响此特性。\n\n 实际使用中，在 TCP 端口可被连通的情况下，再开启 UDP 穿透的提升并不大。\n\n 建议仅在 TCP 穿透通道不可用时才启用 UDP 穿透通道。\n\n ---\n\n改包模式下，**解密 HTTPS Tracker 流量需要信任证书**。该操作只能在当前容器内生效，因此在同一 host 网络下配置多个同方案的穿透时，**HTTPS Tracker 改包仅对最后一个添加规则的容器生效**。（birdge 及 macvlan 网络不受限制）\n\n为避免拦截不必要的 HTTPS 流量而导致网络性能损耗或影响其他程序的通信，仅匹配 [HTTPS Tracker 列表](https://oniicyan.pages.dev/https_trackers.txt) 中的地址与端口。如需要添加自定义 HTTPS Tracker，请编辑 `/BitComet/CustomHttpsTrackers.txt`。\n\n---\n\n对于 HTTP(S) 改包，nftables 规则仅匹配路径为 `/announce` 的 HTTP 请求\n\n以下这样的 Tracker URL 能被识别\n\n`http://example.com/announce`\n\n以下这样的 Tracker URL 会被忽略\n\n`http://example.com/usertoken/announce`\n\n以下这样的 Tracker URL 仍可匹配\n\n`http://example.com/announce.php`\n\n但目前以数据包的二进制偏移量为基准识别并篡改端口，若字符太多将会超出走查范围。（考虑到执行效率，并不会走查整个数据包）\n\n## NAT 类型\n\n本镜像会在启动时 **进行 NAT 映射行为检测，不进行过滤行为检测**，假定用户为 **受限制锥形 NAT**。\n\n可通过容器自动配置 UPnP，或用户自行配置端口映射。其中 **传统模式** 依赖 UPnP，而 **改包模式** 则不限。\n\n## 端口映射\n\n**传统模式** 下，由于 **穿透通道的本地端口与下载器的监听端口不一致且无法固定**，因此需要通过 UPnP 向网关请求一条 **内外不一致** 的端口映射规则。\n\n**改包模式** 巧妙地利用 NAT 优先级的特性，**穿透通道的本地端口与下载器的监听端口一致且始终不变**，因此用户侧网关无需再进行端口映射。但由于防火墙的过滤，仍需要配置 **内外一致** 的端口映射规则以达到防火墙放行的效果。\n\n# 使用说明\n\n## 网络配置\n\n本镜像为提升易用性，尽可能地考虑了用户的网络环境，但仍有需要注意的地方。\n\n### bridge 网络\n\n* **传统模式**：bridge 网络下，容器的 UPnP 的可达性通常受到阻碍。本镜像仍会尝试请求 UPnP 规则，但可能需要用户自行解决可达性问题。\n\n* **改包模式**：bridge 网络下的推荐模式。仅需在容器启动时指定 `-p` 参数映射端口。但 **操作 nftables 需要 `NET_ADMIN` 权限**，当然也可以直接开启 **特权模式 `privileged`**。\n\n### host 网络\n\n* **传统模式**：host 网络下的推荐模式。只要网关开启了 UPnP 功能，可以说是开箱即用。\n\n* **改包模式**：同样需要 `NET_ADMIN` 权限或特权模式。host 网络下，宿主的所有通信（包括其他容器）都会遍历 nftables 规则，尽管规则已尽可能地精确匹配 Tracker 流量。\n\n### macvlan 网络\n\n推荐使用的网络配置，兼顾以上两者的优点。\n\n**传统模式**：同 host 网络\n\n**改包模式**：同 bridge 网络（不干涉容器外的网络通信）\n\n### IPv6\n\nbridge 与 macvlan 网络下如要使用 IPv6，需要额外的配置。详细请自行查阅 Docker 文档。\n\nhost 网络 + 传统模式由于会改变下载器的监听端口，防火墙的 IPv6 规则可能需要更改。\n\n改包模式下的 nftables 规则既不会也不需要干涉任何 IPv6 通信。\n\n## 目录配置\n\n需要挂载的目录为以下三个\n\nBitComet 配置目录：`/BitComet`\n\nBitComet 下载目录：`/Downloads`\n\nPeerBanHelper 目录：`/PeerBanHelper`\n\n以上任意目录若未挂载，则在容器层自动创建，重启时可能会被 Docker 自动清理。\n\n**其余任何额外挂载的目录，都会自动指定为 BirComet 的自定义下载目录**\n\n## 变量说明\n\n本镜像可根据容器启动时配置的环境变量来控制各项功能。\n\n### 基本变量\n\n| 名称 | 说明 | 默认 |\n| --- | --- | --- |\n| BITCOMET_WEBUI_USERNAME | BitComet WebUI 用户名 | 随机生成 |\n| BITCOMET_WEBUI_PASSWORD | BitComet WebUI 密码 | 随机生成 |\n| BITCOMET_WEBUI_PORT | BitComet WebUI 端口 | `8080` |\n| BITCOMET_BT_PORT | BitComet BT 端口 | `56082` |\n| PBH_WEBUI_TOKEN | PeerBanHelper WebUI Token | 随机生成 |\n| PBH_WEBUI_PORT | PeerBanHelper WebUI 端口 | `9898` |\n| PBH | PeerBanHelper 开关 | 无 |\n| STUN | STUN 穿透开关 | 无 |\n\n* 鉴权信息如未指定，则从配置文件中读取；如配置文件也未指定，则随机生成\n\n* 端口如未指定，则使用默认值；如默认端口被占用，则随机使用 `1024-65535` 中未被使用的端口（BT 端口随机范围为 `10000-65535`）\n\n* 启用 STUN 穿透时，BitComet BT 端口会自动更新为公网端口，`BITCOMET_BT_PORT` 将作为穿透通道的本地端口\n\n* PBH 与 STUN 默认启用；如需禁用，请指定为 `0`；不指定或任何非 0 字符都是开启\n\n* 显式指定 `STUN = 1` 时，即使检测结果为公网映射，仍然执行 STUN\n\n　*公网映射下若强制开启传统模式 STUN，会提示端口占用*\n\n### STUN\n\n| 名称 | 说明 | 默认 |\n| --- | --- | --- |\n| StunMode | 穿透模式，可接受以下值
`tcp`：TCP 传统模式
`udp`：UDP 传统模式
`nfttcp`：TCP 改包模式
`nfttcp`：UDP 改包模式
`nftboth`：TCP + UDP 改包模式| 自动检测
无 NET_ADMIN 权限则使用 TCP 传统模式
有 NET_ADMIN 权限则使用 TCP 改包模式 |\n| StunModeHttps | HTTPS 改包开关 | 无（指定 `0` 为禁用） |\n| StunMitmEnPort | HTTPS 加密流量端口 | `58443` |\n| StunMitmDePort | HTTPS 解密流量端口 | `50080` |\n| StunHost | 指定当前容器是否 host 网络
`0`非 host 网络（bridge 或 macvlan 等）
`1`为 host 网络 | 自动检测
检测 `eth0` 的 MAC 地址 |\n| StunInterface | 穿透时使用的网络接口或源 IP | 无（由路由表选择） |\n| StunInterval | 穿透通道检测/保活间隔（秒）| `25` |\n| StunUpnpAddr | UPnP 映射规则的目的地址 | `@`（自动检测本地地址） |\n| StunUpnpInterface | UPnP 发送 [SSDP](https://zh.wikipedia.org/wiki/SSDP) 报文时使用的接口
可填写 IP 地址或接口名称，通常在路由器上运行容器时需要 | 无
若找不到 UPnP 设备，则尝试 `br-lan`（若有） |\n| StunUpnpUrl | UPnP 设备描述文件 (XML) 的 URL
无法使用 [SSDP](https://zh.wikipedia.org/wiki/SSDP) 时需要 | 无 |\n\n* 即使指定了改包模式，若无 NET_ADMIN 权限也会自动变更为传统模式（`nfttcp/nftboth` -> `tcp`, `nftudp` -> `udp`）\n\n* 是否 host 网络的检测方法为判断 `eth0` 的 MAC 地址。使用 Docker 创建的网卡（包括 bridge 或 macvlan 等）默认以 `02:42` 开头，而 host 网络使用宿主网卡，通常为各厂商的登记地址。该检测方法并非 100% 可靠，嵌套容器或指定 MAC 地址启动时会影响检测结果。\n\n* 若穿透通道保持时间低于检测/保活间隔的 3 倍，则自动缩短间隔直至穿透通道稳定\n\n### 其他\n\n| 名称 | 说明 | 默认 |\n| --- | --- | --- |\n| JvmArgs | [Java 虚拟机附加参数](https://docs.oracle.com/cd/E22289_01/html/821-1274/configuring-the-default-jvm-and-java-arguments.html)，仅用作 PeerBanHelper | 无 |\n","has_starred","hub_user","immutable_tags_settings",{"_72":11,"_73":74},"enabled","rules",[75],".*","is_automated","permissions",{"_79":17,"_80":11,"_81":11},"read","write","admin","user","storage_size",1027915739,"orgData",{"_87":88,"_89":90,"_91":92,"_93":29,"_94":95,"_96":97,"_98":97,"_99":97,"_100":101,"_102":97,"_103":97,"_104":97,"_105":17},"id","f41b5cc6181049d5b73e36f6bca44d65","uuid","f41b5cc6-1810-49d5-b73e-36f6bca44d65","type","organization","orgname","full_name","Bitcomet_Post_Bar","location","","company","profile_url","date_joined","2025-01-22T09:06:11.850514Z","gravatar_url","gravatar_email","badge","is_active","recentTags",[108],{"_109":40,"_110":111,"_112":113,"_114":115,"_87":116,"_117":118,"_46":150,"_151":111,"_152":153,"_154":52,"_53":155,"_156":157,"_158":159,"_160":150,"_161":62,"_162":17},"content_type","creator",31357020,"digest","sha256:035506bb19ccba685aec28ec33006fc2d3a822ceeb05a5e6bd5537e559c5a36b","full_size",155309814,842247535,"images",[119,134,140,146],{"_120":121,"_112":122,"_123":97,"_124":125,"_126":127,"_128":129,"_130":97,"_131":-5,"_132":115,"_59":62,"_133":-5},"architecture","amd64","sha256:df10087a310c16a77401f22c1d485d38627486c850969a722737e24e6e27ec60","features","last_pulled","2026-09-23T17:18:19.006005157Z","last_pushed","2025-04-19T14:13:19.313216594Z","os","linux","os_features","os_version","size","variant",{"_120":135,"_112":136,"_123":97,"_124":137,"_126":138,"_128":129,"_130":97,"_131":-5,"_132":139,"_59":62,"_133":-5},"arm64","sha256:fead41687c18d10848f3e78748053ecabcdffc7e723cacb5a23273d53ba94fc3","2026-09-16T15:29:29.712668407Z","2025-04-19T14:13:19.965983695Z",150434788,{"_120":141,"_112":142,"_123":97,"_124":143,"_126":144,"_128":141,"_130":97,"_131":-5,"_132":145,"_59":62,"_133":-5},"unknown","sha256:e4bf2d99bde79fccaf0977b82eb6a46dec1813fefb2d721124e6b712507db41d","2026-09-16T15:29:29.664258155Z","2025-04-19T14:13:20.616816115Z",18719,{"_120":141,"_112":147,"_123":97,"_124":148,"_126":149,"_128":141,"_130":97,"_131":-5,"_132":145,"_59":62,"_133":-5},"sha256:a44f860e729c2b2fda2a426d0d8a84bcd1eb329bbbfbe3f7df48d3a60e4e8d28","2026-09-16T15:29:29.688826888Z","2025-04-19T14:13:21.035181493Z","2025-04-19T14:13:21.802751Z","last_updater","last_updater_username","oniicyan99","media_type","latest","repository",26368718,"tag_last_pulled","2026-09-24T01:02:58.623778756Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":174,"_181":182,"_170":194,"_195":11},{"_36":175,"_38":176,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":177,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":65,"_66":67,"_68":11,"_69":29,"_70":178,"_76":11,"_77":180,"_82":29,"_83":84},[],[40],[52],{"_72":11,"_73":179},[75],{"_79":17,"_80":11,"_81":11},"tags",{"_183":60,"_184":-5,"_185":-5,"_186":187},"count","next","previous","results",[188],{"_109":40,"_110":111,"_112":113,"_114":115,"_87":116,"_117":189,"_46":150,"_151":111,"_152":153,"_154":52,"_53":155,"_156":157,"_158":159,"_160":150,"_161":62,"_162":17},[190,191,192,193],{"_120":121,"_112":122,"_123":97,"_124":125,"_126":127,"_128":129,"_130":97,"_131":-5,"_132":115,"_59":62,"_133":-5},{"_120":135,"_112":136,"_123":97,"_124":137,"_126":138,"_128":129,"_130":97,"_131":-5,"_132":139,"_59":62,"_133":-5},{"_120":141,"_112":142,"_123":97,"_124":143,"_126":144,"_128":141,"_130":97,"_131":-5,"_132":145,"_59":62,"_133":-5},{"_120":141,"_112":147,"_123":97,"_124":148,"_126":149,"_128":141,"_130":97,"_131":-5,"_132":145,"_59":62,"_133":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
df10087a310c	linux/amd64	148.11 MB
fead41687c18	linux/arm64	143.47 MB

bitcometpostbar/bitcomet

Tags for bitcometpostbar/bitcomet