Resin 代理池网关部署与使用笔记

一、部署配置

Docker Compose 配置

services:
  resin:
    image: ghcr.io/resinat/resin:latest
    container_name: resin
    restart: unless-stopped
    environment:
      RESIN_AUTH_VERSION: "V1"
      RESIN_ADMIN_TOKEN: "你的管理员密码"
      RESIN_PROXY_TOKEN: "你的代理密码"
      RESIN_LISTEN_ADDRESS: 0.0.0.0
      RESIN_PORT: 2260
      RESIN_CORS_ALLOWED_ORIGINS: "*"   # 允许跨域访问
    ports:
      - "2260:2260"
    volumes:
      - ./data/cache:/var/cache/resin
      - ./data/state:/var/lib/resin
      - ./data/log:/var/log/resin

启动命令

1	docker compose up -d

常用管理命令

# 查看日志
docker logs resin --tail 50

# 重启服务
docker compose restart

# 停止服务
docker compose down

# 停止并删除数据（慎重）
docker compose down -v

二、关键配置信息（请替换为实际值）

配置项	示例值	说明
服务地址	`http://你的IP:2260`	Resin 服务入口
Web UI	`http://你的IP:2260/ui`	管理后台
管理员密码	`你的ADMIN_TOKEN`	登录 Web UI 用
代理密码	`你的PROXY_TOKEN`	代理认证用
平台名称	`us`	自定义平台名

三、代理使用方式

1. 基础代理地址

1	http://你的IP:2260

2. 认证格式

模式	用户名格式	密码
非粘滞（随机节点）	`平台名`	`你的PROXY_TOKEN`
粘滞（固定出口IP）	`平台名.账号名`	`你的PROXY_TOKEN`

3. 使用示例

curl 命令

# 非粘滞模式
curl -x http://你的IP:2260 -U "us:你的PROXY_TOKEN" https://api.ipify.org

# 粘滞模式（推荐）
curl -x http://你的IP:2260 -U "us.业务账号:你的PROXY_TOKEN" https://api.ipify.org

# 合并写法
curl -x http://us.业务账号:你的PROXY_TOKEN@你的IP:2260 https://api.ipify.org

四、平台配置-示例

创建美国节点平台

登录 Web UI：http://你的IP:2260/ui
进入 Platforms → Create Platform
平台名称：us
Region Filters（地区过滤）：
1
us
保存

其他常用地区代码

地区	代码
美国	`us`
日本	`jp`
香港	`hk`
新加坡	`sg`
韩国	`kr`
台湾	`tw`
英国	`gb`
德国	`de`

笔记结束。所有 你的IP、你的PROXY_TOKEN、你的ADMIN_TOKEN 等占位符，请替换为实际部署时的真实值。