Docker 版 AFRP 内网穿透客户端，通过浏览器管理 frpc。无需安装桌面应用，一键部署即可使用。
Github仓库：https://github.com/afrpnet/afrp-docker
Docker仓库：https://hub.docker.com/r/afrp/afrp

特性

• 🌐 纯 Web 界面：浏览器访问，跨平台兼容，无需安装客户端
• 🔐 OIDC 认证：复用官网账号登录，密钥按账号独立保存
• 👥 多账号切换：登录页可保存多个账号，一键切换，各自记住服务器与密钥
• 🖥 服务器记忆：每个账号记住上次选择的服务器，登录后自动回填，无需重新选择
• 🔒 连接中锁定：frpc 运行期间服务器下拉框锁定，避免误切节点导致断连
• 🛠 隧道管理：Web 界面增删改隧道（TCP/UDP/HTTP/HTTPS/STCP/SUDP/XTCP）
• 📊 实时日志：Web 界面查看 frpc 运行日志
• 💾 配置持久化：Docker volume 保存配置、密钥、隧道
• ✅ 官方内核：直接使用 fatedier/frp 官方镜像中的 frpc，保证版本正确性

快速开始

# 拉取镜像
docker pull afrp/afrp

# 运行容器
docker run -d \
  --name afrp-web \
  --restart unless-stopped \
  -p 8000:8000 \
  -p 7400:7400 \
  -v afrp-data:/data \
  afrp/afrp

⚠️ -v afrp-data:/data 必须挂载。配置、Client Secret、隧道都存放在 /data 下，漏挂卷会新建匿名卷，表现为「重启后又要重新登录、密钥又变成未设置」。

💡 -p 7400:7400 是 frpc 自带管理面板的端口，映射后容器外才能打开面板；不用管理面板可以不映射。

访问 Web UI：http://localhost:8000

使用说明

1. 登录：输入官网账号和密码，勾选「记住我」可保存账号以便下次一键登录
2. 服务器：选择节点。系统会按账号记住这次选择，下次登录自动回填；frpc 运行期间下拉框锁定，需先停止才能切换
3. Client Secret：首次使用需粘贴官网「连接说明」里的密钥，或在页面点击「生成新密钥」由官网接口签发。密钥按账号保存，切换账号时自动取用对应密钥并写入 frpc.toml
4. 隧道：点击「+ 添加隧道」填写名称、类型、本地 IP/端口等信息，保存后自动重启 frpc 使其立即生效；「隧道管理」标题右侧的「配置文件」可打开 frpc.toml 直接编辑，保存后文件里的隧道会同步到隧道列表，并自动重启 frpc；在 frpc 管理面板的「配置」页改过 frpc.toml 后，回到网页点「刷新」即可看到这些隧道
5. 启动：点击「启动」按钮，frpc 开始运行；「停止」可断开
6. 管理面板：「状态」下方的小字勾选项「启用 frpc 管理面板」可开启 frpc 自带的 Web 面板，勾选后自动生成随机账号密码、写入 frpc.toml 的 webServer 段和 [store] 段并重启 frpc，下方会显示面板地址、账号和密码（Docker 部署需映射该端口，-p 7400:7400）
7. 监控：查看运行状态与实时日志
8. 主题：登录卡片右上角（登录后位于「退出登录」旁）可切换深色 / 浅色，默认跟随系统，选择结果记在浏览器本地

升级

镜像发布后按以下顺序更新（务必保留数据卷）：

docker stop afrp-web && docker rm afrp-web
docker pull afrp/afrp:latest
docker run -d --name afrp-web --restart unless-stopped -p 8000:8000 -p 7400:7400 -v afrp-data:/data afrp/afrp:latest

配置说明

数据持久化

配置和日志保存在 Docker volume afrp-data 中：

# 查看配置目录
docker exec afrp-web ls /data

# 备份配置
docker run --rm -v afrp-data:/data -v $(pwd):/backup alpine tar czf /backup/afrp-backup.tar.gz /data

# 恢复配置
docker run --rm -v afrp-data:/data -v $(pwd):/backup alpine tar xzf /backup/afrp-backup.tar.gz -C /

config.json 中几个关键字段：

管理面板与隧道管理

「状态」下方勾选「启用 frpc 管理面板」后，页面自动生成随机账号密码并写入 frpc.toml 的 webServer 段与 [store] 段，同时重启 frpc 使配置生效；下方提示里会给出面板地址、账号和密码。

启用管理面板后，frpc 会在代理存储文件 /data/config/frpc_store.json 中记录面板里增删改的隧道。

• 「隧道管理」列表会合并三处记录：网页里添加的隧道、面板里创建的隧道、frpc.toml 里的隧道，点「刷新」即可看到最新改动
• 面板创建的隧道会并入 config.json 的隧道列表，之后可以直接在网页里编辑、删除；改动同时写回存储文件，frpc 侧保持一致
• 面板的「配置」页直接改写 /data/config/frpc.toml，改动后点「刷新」，这些隧道同样会并入列表，标有「配置文件」角标
• 在 frpc.toml 里改了 webServer.user / webServer.password，账号密码会同步回 config.json，页面提示里的账号密码随之改变，重新生成配置时也不会被旧值覆盖
• 名称相同的隧道以面板记录为准，避免 frpc 因代理重名启动失败
• 隧道增删改后会重新生成 frpc.toml 并重启 frpc，改动立即生效
• 重新生成 frpc.toml 时会保留面板设置的其它字段（如 transport.useEncryption），不会因为在网页里编辑就丢失
• 字段不全的隧道（缺 name/type/localIP/localPort，或 http 缺域名）在 frpc.toml 里整段注释掉，不会让 frpc 启动失败，补全后自动恢复
• frpc 启动时同样会校验存储文件里的代理，所以存储文件里字段不全的记录会被自动清掉，配置仍保留在隧道列表里待修复
• 未启用管理面板时，frpc 不加载代理存储文件，列表只显示网页里的隧道和 frpc.toml 里的隧道