Cobalt 如何配置 FREEBIND_CIDR 让每次下载使用随机出口 IP【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobalt如果你自托管了一个 Cobalt 实例希望每一次下载任务都从不同出口 IP 发出请求可以在 API 实例上配置FREEBIND_CIDR。官方文档说明设置该变量后cobalt to pick a random IP for every download and use it for all requests it makes for that particular download即每次下载随机取一个 IP并且该次下载产生的所有外部请求都固定使用这个 IP。适用前提系统为 Linux且实例由你自己部署Docker Compose 或 Node.js 两种运行方式均支持该配置。FREEBIND_CIDR 的作用与适用条件FREEBIND_CIDR是一个 API 实例的环境变量默认值为空示例值为2001:db8::/32含义是用于为 cobalt 请求随机分配地址的 IPv6 前缀见 docs/run-an-instance.md 的环境变量表。围绕它有三条明确的适用条件仅支持 Linux环境变量表中写明 only supported on linux systems代码中该配置也只在 Linux 平台被读取src/modules/config.js非 Linux 下设置无效。宿主机要先装好 freebind文档要求先按 freebind.js 包的 setup 说明完成安装再配置 Cobalt。freebind也是本项目的依赖之一package.json 中版本为^0.2.2。不能与外部代理同时使用API_EXTERNAL_PROXY与 freebind 互斥。若两个变量同时设置API 启动时会抛出错误Freebind is not available when external proxy is enabledsrc/core/api.js。随机取 IP 的具体逻辑在 src/modules/processing/match.js配置存在时每次匹配请求会通过freebind.ip.random(env.freebindCIDR)取一个随机地址并用它构造该次请求的 dispatcher。前置准备已按 docs/run-an-instance.md 的推荐方式准备好docker和docker-compose本文主路径为 Docker 部署Node.js 方式则要求 Node.js 18 及以上和git。已按 freebind.js 的 setup 说明在宿主机完成 freebind 安装。这一步在 Docker 场景下是宿主机层面的操作与容器配置分开进行。准备一个可用的 IPv6 前缀作为FREEBIND_CIDR的值。文档给出的示例值是2001:db8::/32实际部署时替换为你自己的前缀。配置 Docker 实例主路径按 docs/run-an-instance.md 的步骤创建配置目录和docker-compose.yml从 docs/examples/docker-compose.example.yml 复制示例配置后只需修改cobalt-api服务新增FREEBIND_CIDR和API_LISTEN_ADDRESS两个环境变量并把容器的network_mode设为host。文档原文指出在 Docker 容器中使用 freebind 时you also need to set theAPI_LISTEN_ADDRESSenv to127.0.0.1, and setnetwork_modefor the container tohost。cobalt-api服务修改后大致如下在示例配置基础上调整cobalt-api: image: ghcr.io/imputnet/cobalt:7 restart: unless-stopped container_name: cobalt-api init: true network_mode: host environment: # 替换为你自己实例的目标 URL否则 cobalt 无法正常工作 API_URL: https://api.cobalt.tools/ API_NAME: eu-nl # 你的 IPv6 前缀用于每次下载随机取出口 IP FREEBIND_CIDR: 2001:db8::/32 # freebind 场景下必须固定为 127.0.0.1 API_LISTEN_ADDRESS: 127.0.0.1 labels: - com.centurylinklabs.watchtower.scopecobalt需要注意两点示例配置中cobalt-api的ports: 9000:9000/tcp段对应常规端口映射改用network_mode: host后端口映射不再需要把该段注释或删除。API_URL必须替换为你实例自己的地址文档要求 make sure to replace default URLs with your own or cobalt wont work correctly且它是运行 API 的必需项。cobalt-web服务不需要为 freebind 做任何改动freebind 只作用于 API 发出的下载请求。改完后在配置目录下启动或重启容器docker compose up -d替代路径Node.js 方式运行如果是本地开发或不用 Docker走 docs/run-an-instance.md 的 using regular node.js 一节clone 仓库、运行npm run setup并在交互提示中选择 API 实例最后用npm start启动。freebind 只需在启动前把环境变量注入 shellexport FREEBIND_CIDR2001:db8::/32 # 替换为你的 IPv6 前缀 npm startLinux 之外的平台该变量不会被读取无需配置。验证配置是否生效由于 freebind 要求API_LISTEN_ADDRESS为127.0.0.1配置完成后 API 只监听宿主机本机的 9000 端口。可以从宿主机请求 docs/api.md 中记录的GET /api/serverInfo接口确认服务按新配置正常启动curl http://127.0.0.1:9000/api/serverInfo该接口返回application/json包含version、commit、branch、name、url、cors、startTime字段。能正常返回说明 API 已按127.0.0.1:9000监听并可用。对于每次下载是否真的换了 IP文档没有提供直接查看每次请求所用地址的方法可依据的是文档对该变量行为的描述——随机 IP 会在该次下载的所有请求中被使用。判断配置是否被启用以启动日志和环境变量为准若同时设置了API_EXTERNAL_PROXYAPI 会因上面提到的错误拒绝启动这也是一种快速判断。限制说明FREEBIND_CIDR只在 Linux 系统上生效且前提是宿主机已按 freebind.js 的 setup 说明完成安装缺少这一步时该变量没有实际作用。该变量与API_EXTERNAL_PROXY互斥二者只能选其一作为出口控制方式。Docker 部署时实例对外暴露方式随之改变监听地址固定为127.0.0.1后公网访问需要文档建议的 reverse proxy如 nginx配合文档未给出 freebind 场景下的具体代理配置。【免费下载链接】cobaltbest way to save what you love项目地址: https://gitcode.com/GitHub_Trending/cob/cobalt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
