群晖 NAS 使用 Docker 部署 Lolia FRP 实现多隧道内网穿透

前言

Lolia FRP 是基于 FRP 的定制版内网穿透工具，支持通过 TOML 配置文件管理隧道。本文介绍如何在群晖 NAS 上通过 Docker 部署 Lolia FRP 客户端，并实现多个隧道同时运行。

一、准备配置文件

1.1 创建配置目录

在群晖文件系统中创建配置文件目录：

/volume1/docker/lolia-frp/

1.2 编写 frpc.toml

多个隧道只需在同一个 toml 文件中追加多个 [[proxies]] 块即可，服务端信息只写一次。

serverAddr = 'cn-dy-1.qwq.fan'
serverPort = 7000
user = '你的用户名'
transport.tls.serverName = " "

[metadatas]
token = '你的token'

# 隧道一
[[proxies]]
name = '隧道一的name'
type = 'http'
localIP = '127.0.0.1'
localPort = 5001
customDomains = ['yy.example.com']
transport = {bandwidthLimit = '7MB', bandwidthLimitMode = 'server'}

# 隧道二
[[proxies]]
name = '隧道二的name'
type = 'http'
localIP = '127.0.0.1'
localPort = 298
customDomains = ['www.example.com']
transport = {bandwidthLimit = '7MB', bandwidthLimitMode = 'server'}

说明：

• [metadatas] 中的 token 是 Lolia FRP 平台的鉴权凭证，注意与标准 FRP 的 auth.token 区分。
• transport 使用行内写法，等价于 [proxies.transport] 子块，更简洁。
• 每个隧道的 name 必须唯一，从 Lolia FRP 控制台获取。
  如果穿透的是https的服务直接修改type类型即可

二、Docker 部署

2.1 使用 Docker 命令启动

sudo docker run -d \
  --name frpc \
  --restart always \
  --network host \
  -v /volume1/docker/lolia-frp/frpc.toml:/etc/frp/frpc.toml \
  ghcr.io/lolia-frp/loliacli-frpc:latest \
  -c /etc/frp/frpc.toml

参数说明：

2.2 使用 Docker Compose 启动（推荐）

在 /volume1/docker/lolia-frp/ 目录下创建 docker-compose.yml：

services:
  frpc:
    image: ghcr.io/lolia-frp/loliacli-frpc:latest
    container_name: frpc
    restart: always
    network_mode: host
    volumes:
      - /volume1/docker/lolia-frp/frpc.toml:/etc/frp/frpc.toml
    command: -c /etc/frp/frpc.toml

然后执行：

sudo docker-compose up -d

三、常用管理命令

查看运行日志

sudo docker logs -f frpc

正常连接成功的日志关键字：login to server success

重启容器

sudo docker restart frpc

重启群晖 Docker 服务

sudo systemctl restart pkg-Docker-dockerd.service

查看容器网络模式

sudo docker inspect frpc --format '{{json .HostConfig.NetworkMode}}'

停止并删除容器

sudo docker rm -f frpc

四、常见问题排查

❌ session shutdown / connection reset by peer

• 原因：服务端拒绝连接，通常是 token 错误、版本不匹配或服务端故障。

• 排查：

  nc -zv cn-dy-1.qwq.fan 7000

  若连接被拒，说明服务端问题，联系服务商确认节点状态。

❌ su-exec: -c: No such file or directory

• 原因：镜像 entrypoint 与传入参数冲突。
• 解决：确认使用 ghcr.io/lolia-frp/loliacli-frpc:latest 镜像，该镜像支持 -c 参数。

❌ 配置修改后不生效

• 修改 toml 文件后需重启容器：

  sudo docker restart frpc

五、总结