Sign inSign up

kouleen/frps

By kouleen

•Updated 4 months ago

Frp Server service image

Image
Networking
Developer tools
1

353

kouleen/frps repository overview

⁠🚀 kouleen/frps - 新一代 FRP 服务端镜像(基于 TOML 配置 + 环境变量一键启动)

⁠镜像简介

kouleen/frps 是基于 Alpine Linux 构建的极简、稳定、现代化 FRP 服务端镜像。 内置自动生成配置脚本,无需手动编写 frps.toml,全部通过环境变量一键启动,支持最新版 FRP,性能强、部署快,专为公网服务器内网穿透设计。


⁠🔥 核心特性

✅ 纯环境变量启动 → 不用挂载配置,一行命令跑起来
✅ 自动生成 frps.toml → 脚本自动生成最新版 TOML 格式配置
✅ 支持最新版 FRP → 兼容 frp v0.60.0+
✅ 内置 Web 管理面板 → 实时查看客户端、流量、在线状态
✅ 安全鉴权 → Token 验证,防止非法连接
✅ 超轻量 → 仅几 MB,低配置服务器也能流畅跑
✅ 持久日志 → 日志自动切割,保留 3 天
✅ 自动重启 → 崩溃自动恢复,长期稳定运行


⁠🌐 默认端口

  • 7000 → FRP 服务通信端口(必须开放)
  • 7500 → FRP Web 管理面板端口

⁠🚀 快速启动(推荐:一行命令)

docker run -d \
  --name frps \
  --restart always \
  -p 7000:7000/tcp \
  -p 7000:7000/udp \
  -p 7500:7500 \
  -e AUTH_TOKEN="your-custom-token" \
  kouleen/frps:tagname

⁠⚙️ 完整环境变量启动(自定义所有参数)

docker run -d \
  --name frps \
  --restart always \
  --net=host \
  -e BIND_PORT=7000 \
  -e WEB_PORT=7500 \
  -e WEB_USER=admin \
  -e WEB_PASS=123456 \
  -e AUTH_TOKEN=my-frp-secure-token-2026 \
  -e LOG_LEVEL=info \
  -e LOG_MAX_DAYS=7 \
  kouleen/frps:tagname

⁠📘 环境变量说明(全部支持自定义)

变量名说明默认值
BIND_ADDR绑定地址0.0.0.0
BIND_PORTFRP 服务端口7000
KCP_BIND_PORTKCP 端口7000
WEB_ADDR面板绑定地址0.0.0.0
WEB_PORTWeb 面板端口7500
WEB_USER面板账号admin
WEB_PASS面板密码admin
AUTH_TOKEN连接密钥(最重要)kouleen-2026-default-token
LOG_TO日志输出方式console
LOG_LEVEL日志等级info
LOG_MAX_DAYS日志保留天数3
AUTH_METHOD认证方式token

⁠🌐 访问 Web 管理面板

地址:http://你的服务器IP:7500
账号:WEB_USER
密码:WEB_PASS

可查看:

  • 在线客户端
  • 端口穿透列表
  • 流量统计
  • 连接日志

⁠📂 容器内部结构

/app/frps          → frps 二进制文件
/app/frps.toml     → 自动生成的配置文件
/app/frps.log      → 日志文件

⁠🛠 常用管理命令

# 查看状态
docker ps | grep frps

# 查看启动日志
docker logs -f frps

# 重启(修改环境变量后)
docker restart frps

# 停止
docker stop frps

# 删除
docker rm -f frps

# 更新镜像
docker pull kouleen/frps:latest

⁠✅ 查看启动成功标志

日志出现以下内容表示启动成功:

========================================
✅ frps 配置已生成
📡 监听端口: 7000
🔐 Token: your-custom-token
🌐 Web面板: http://0.0.0.0:7500
👤 Web账号: admin / admin
========================================

⁠🔗 客户端 frpc.toml 配置示例

serverAddr = "你的服务器IP"
serverPort = 7000
auth.token = "your-custom-token"

[[proxies]]
name = "web"
type = "tcp"
localIP = "127.0.0.1"
localPort = 80
remotePort = 8080

⁠📌 适用场景

  • 公网服务器搭建 FRP 穿透服务
  • 内网网站、SSH、远程桌面、游戏服务穿透
  • 个人/团队/公司内网穿透网关
  • 低配置云服务器稳定运行

⁠📝 常见问题

⁠Q1:必须写配置文件吗?

不需要! 本镜像自动生成 frps.toml,只用环境变量就能启动。

⁠Q2:如何修改 Token?

修改 AUTH_TOKEN 环境变量,重启容器即可。

⁠Q3:Web 面板打不开?

安全组/防火墙放行 7500 端口。

⁠Q4:能长期在公网使用吗?

可以,安全、轻量、无后门、稳定可靠。


⁠👤 作者信息

🐳 Docker Hub: kouleen/frps⁠
⭐ 好用请点个 Star 支持一下!

Tag summary

Content type

Image

Digest

sha256:86f5a0af2…

Size

11.2 MB

Last updated

4 months ago

docker pull kouleen/frps:0.69.0