HUB
Sign inSign up
frp logo

micrograils/frp

By micrograils

•Updated 6 days ago

Ultra-lightweight multi-arch image for fatedier/frp - expose local services behind NAT/firewall.

Image
Networking
Security
Developer tools
0

9.8K

micrograils/frp repository overview

⁠frp Docker 镜像

Docker Image Size Docker Pulls Platforms

一句话:把内网服务"无痛"暴露到公网的最小镜像。
镜像大小 < 20 MB,零依赖,支持 AMD64 / ARM64。


⁠1. 30 秒上手

目标:把内网容器 8080 端口映射到公网 28080 端口。

节点IP 示例角色
公网服务器 A1.2.3.4frps(服务端)
内网服务器 B192.168.1.100frpc(客户端)

⁠1.1 服务端(公网 A)
  1. 创建 frps.toml
bindPort = 7000
auth.token = "REPLACE_ME_WITH_RANDOM_STRING"
  1. 启动
docker run -d --name frps \
  -p 7000:7000 \
  -v $PWD/frps.toml:/etc/frp/frps.toml \
  -e FRP_MODE=server \
  --restart unless-stopped \
  micrograils/frp

⁠1.2 客户端(内网 B)
  1. 创建 frpc.toml
serverAddr = "1.2.3.4"
serverPort = 7000
auth.token = "REPLACE_ME_WITH_RANDOM_STRING"   # 必须与服务端一致

[[proxies]]
name = "web-8080"
type = "tcp"
localIP = "127.0.0.1"
localPort = 8080
remotePort = 28080
  1. 启动
docker run -d --name frpc \
  --network host \
  -v $PWD/frpc.toml:/etc/frp/frpc.toml \
  -e FRP_MODE=client \
  --restart unless-stopped \
  micrograils/frp
  1. 验证
    浏览器访问 http://1.2.3.4:28080,即可打开内网服务。

⁠1.3 进阶用法
场景配置入口
多协议(tcp / udp / http / https / stcp / xtcp)参考 frpc_full_example.toml⁠
TLS 加密、压缩、负载均衡、Prometheus 监控同上
自定义 frps 监听地址、Dashboard、子域名参考 frps_full_example.toml⁠

⁠1.4 环境变量
变量默认值说明
FRP_MODE无必填,server 或 client
FRP_CONF/etc/frp/frps.toml 或 /etc/frp/frpc.toml自定义配置文件路径

⁠1.5 持久化 & 升级
# 升级镜像(零停机)
docker pull micrograils/frp
docker stop frps && docker rm frps
# 重新执行 docker run … 即可,配置无需改动

⁠1.6 安全提示
  • 务必替换默认 auth.token,长度 ≥ 32 位随机字符串。
  • 公网端口仅开放必要端口(7000 与所需 remotePort)。
  • 生产环境建议开启 tls.enable = true 并配合防火墙限速。

⁠相关链接


维护者文档(构建 / 版本管理 / 测试 / 维护)见 MAINTENANCE.md⁠。

Tag summary

Content type

Image

Digest

sha256:7da8de5ea…

Size

18.2 MB

Last updated

6 days ago

docker pull micrograils/frp