1. 为什么需要在Ubuntu上部署frpcfrpcFast Reverse Proxy Client是内网穿透工具frp的客户端组件它能够帮助我们将局域网内的服务安全地暴露到公网。在Ubuntu服务器环境下部署frpc具有以下典型应用场景远程开发调试当你在公司内网的Ubuntu开发机上运行了Web服务如Django/Flask应用需要让外网的同事或客户临时访问时frpc可以快速建立隧道而无需修改公司防火墙规则。家庭NAS访问家用Ubuntu服务器上的Nextcloud、Jellyfin等自建服务通过frpc穿透家庭宽带NAT实现随时随地访问。我曾在家庭服务器上配置过Samba文件共享通过frp实现远程办公时安全访问家中文件。IoT设备管理树莓派等嵌入式设备运行Ubuntu Core时通过轻量级frpc实现远程SSH管理。去年我帮朋友部署的智能温室监控系统就采用了这种方案。重要提示使用前请确保你有合法的穿透需求并已获得对应网络的管理权限。内网穿透可能带来安全风险建议配合防火墙规则限制访问IP。2. 安装准备与环境检查2.1 硬件与系统要求虽然frpc本身资源占用极低内存通常10MB但根据我的实测经验建议CPUx86_64或ARM架构均可树莓派也能完美运行内存至少128MB空闲内存实际测试64MB也能运行但可能不稳定磁盘5MB以上剩余空间系统Ubuntu 18.04及以上LTS版本非LTS版可能存在兼容性问题通过以下命令检查系统架构和版本# 查看系统架构 uname -m # 查看Ubuntu版本 lsb_release -a2.2 网络环境预检在开始安装前必须确认出站连接frpc需要能访问frps服务端默认7000端口telnet your_frps_server 7000如果提示Command telnet not found先安装sudo apt install telnet -y防火墙状态sudo ufw status如果激活状态需要放行frpc相关端口sudo ufw allow out 7000/tcp # frps控制端口 sudo ufw allow out 7001/tcp # 可选数据传输端口3. 三种安装方式详解3.1 官方二进制直接安装推荐新手这是最快捷的方式适合快速验证场景获取最新release版本以v0.52.3为例wget https://github.com/fatedier/frp/releases/download/v0.52.3/frp_0.52.3_linux_amd64.tar.gz解压并进入目录tar -zxvf frp_0.52.3_linux_amd64.tar.gz cd frp_0.52.3_linux_amd64验证可执行文件./frpc -v应该输出类似frpc version 0.52.3的版本信息实测发现直接下载的二进制文件可能没有执行权限需要chmod x frpc3.2 通过APT仓库安装适合生产环境对于需要长期运行的服务器建议使用包管理工具添加第三方仓库需确认信任该源sudo add-apt-repository ppa:frp/stable sudo apt update安装frpcsudo apt install frpc验证安装which frpc应该返回/usr/bin/frpc3.3 从源码编译安装定制化需求当需要特定功能或ARM架构适配时安装Go语言环境需要1.20版本sudo apt install golang -y克隆源码git clone https://github.com/fatedier/frp.git cd frp编译客户端make frpc生成的二进制文件在bin/frpc4. 配置文件深度解析4.1 基础配置模板创建配置文件frpc.ini建议放在/etc/frp/目录[common] server_addr your_frps_domain_or_ip server_port 7000 token your_secure_token # 必须与服务端一致 [ssh] type tcp local_ip 127.0.0.1 local_port 22 remote_port 6000 # 通过该端口访问内网SSH4.2 关键参数详解连接保持应对网络波动[common] tcp_mux true heartbeat_interval 30 heartbeat_timeout 90日志配置排查问题必备[common] log_file /var/log/frpc.log log_level info log_max_days 3Web管理界面监控状态[common] admin_addr 127.0.0.1 admin_port 7400 admin_user admin admin_pwd your_password4.3 多服务配置示例同时暴露SSH和Web服务[web] type http local_port 8080 custom_domains your.domain.com [mysql] type tcp local_ip 192.168.1.100 # 同局域网其他主机 local_port 3306 remote_port 33075. 系统服务化与自动启动5.1 创建Systemd服务创建服务文件/etc/systemd/system/frpc.service[Unit] DescriptionFrp Client Service Afternetwork.target [Service] Typesimple Usernobody Restarton-failure RestartSec5s ExecStart/usr/bin/frpc -c /etc/frp/frpc.ini ExecReload/usr/bin/frpc reload -c /etc/frp/frpc.ini [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable frpc sudo systemctl start frpc5.2 日志查看技巧实时查看日志journalctl -u frpc -f按时间筛选journalctl -u frpc --since 2024-01-01 --until 2024-01-026. 安全加固方案6.1 连接加密配置在[common]节添加tls_enable true disable_custom_tls_first_byte false6.2 访问控制IP白名单[common] allow_ports 6000-6005,8000-9000API保护[common] authenticate_new_work_conns true6.3 权限最小化建议使用非root用户运行配置文件权限设置为600chmod 600 /etc/frp/frpc.ini7. 常见问题排查指南7.1 连接失败分析症状dial tcp timeout可能原因服务端防火墙未放行端口# 在服务端测试 sudo netstat -tulnp | grep 7000客户端网络出站限制curl -v http://your_frps:70007.2 端口冲突处理修改remote_port为未被占用的端口ss -tulnp | grep 60007.3 性能调优对于高并发场景[common] pool_count 58. 高阶配置技巧8.1 负载均衡配置多台frpc客户端共同提供服务[web] type http local_port 80 custom_domains your.domain.com group web_servers group_key your_group_password8.2 健康检查机制[web] health_check_type http health_check_url /status health_check_interval_s 10 health_check_timeout_s 3 health_check_max_failed 38.3 带宽限制限制单个代理带宽单位MB[ssh] bandwidth_limit 10 
长河君 · 2026/10/24 8:21:22 · 阅读 1.2k Ubuntu部署frpc内网穿透全攻略
1. 为什么需要在Ubuntu上部署frpcfrpcFast Reverse Proxy Client是内网穿透工具frp的客户端组件它能够帮助我们将局域网内的服务安全地暴露到公网。在Ubuntu服务器环境下部署frpc具有以下典型应用场景远程开发调试当你在公司内网的Ubuntu开发机上运行了Web服务如Django/Flask应用需要让外网的同事或客户临时访问时frpc可以快速建立隧道而无需修改公司防火墙规则。家庭NAS访问家用Ubuntu服务器上的Nextcloud、Jellyfin等自建服务通过frpc穿透家庭宽带NAT实现随时随地访问。我曾在家庭服务器上配置过Samba文件共享通过frp实现远程办公时安全访问家中文件。IoT设备管理树莓派等嵌入式设备运行Ubuntu Core时通过轻量级frpc实现远程SSH管理。去年我帮朋友部署的智能温室监控系统就采用了这种方案。重要提示使用前请确保你有合法的穿透需求并已获得对应网络的管理权限。内网穿透可能带来安全风险建议配合防火墙规则限制访问IP。2. 安装准备与环境检查2.1 硬件与系统要求虽然frpc本身资源占用极低内存通常10MB但根据我的实测经验建议CPUx86_64或ARM架构均可树莓派也能完美运行内存至少128MB空闲内存实际测试64MB也能运行但可能不稳定磁盘5MB以上剩余空间系统Ubuntu 18.04及以上LTS版本非LTS版可能存在兼容性问题通过以下命令检查系统架构和版本# 查看系统架构 uname -m # 查看Ubuntu版本 lsb_release -a2.2 网络环境预检在开始安装前必须确认出站连接frpc需要能访问frps服务端默认7000端口telnet your_frps_server 7000如果提示Command telnet not found先安装sudo apt install telnet -y防火墙状态sudo ufw status如果激活状态需要放行frpc相关端口sudo ufw allow out 7000/tcp # frps控制端口 sudo ufw allow out 7001/tcp # 可选数据传输端口3. 三种安装方式详解3.1 官方二进制直接安装推荐新手这是最快捷的方式适合快速验证场景获取最新release版本以v0.52.3为例wget https://github.com/fatedier/frp/releases/download/v0.52.3/frp_0.52.3_linux_amd64.tar.gz解压并进入目录tar -zxvf frp_0.52.3_linux_amd64.tar.gz cd frp_0.52.3_linux_amd64验证可执行文件./frpc -v应该输出类似frpc version 0.52.3的版本信息实测发现直接下载的二进制文件可能没有执行权限需要chmod x frpc3.2 通过APT仓库安装适合生产环境对于需要长期运行的服务器建议使用包管理工具添加第三方仓库需确认信任该源sudo add-apt-repository ppa:frp/stable sudo apt update安装frpcsudo apt install frpc验证安装which frpc应该返回/usr/bin/frpc3.3 从源码编译安装定制化需求当需要特定功能或ARM架构适配时安装Go语言环境需要1.20版本sudo apt install golang -y克隆源码git clone https://github.com/fatedier/frp.git cd frp编译客户端make frpc生成的二进制文件在bin/frpc4. 配置文件深度解析4.1 基础配置模板创建配置文件frpc.ini建议放在/etc/frp/目录[common] server_addr your_frps_domain_or_ip server_port 7000 token your_secure_token # 必须与服务端一致 [ssh] type tcp local_ip 127.0.0.1 local_port 22 remote_port 6000 # 通过该端口访问内网SSH4.2 关键参数详解连接保持应对网络波动[common] tcp_mux true heartbeat_interval 30 heartbeat_timeout 90日志配置排查问题必备[common] log_file /var/log/frpc.log log_level info log_max_days 3Web管理界面监控状态[common] admin_addr 127.0.0.1 admin_port 7400 admin_user admin admin_pwd your_password4.3 多服务配置示例同时暴露SSH和Web服务[web] type http local_port 8080 custom_domains your.domain.com [mysql] type tcp local_ip 192.168.1.100 # 同局域网其他主机 local_port 3306 remote_port 33075. 系统服务化与自动启动5.1 创建Systemd服务创建服务文件/etc/systemd/system/frpc.service[Unit] DescriptionFrp Client Service Afternetwork.target [Service] Typesimple Usernobody Restarton-failure RestartSec5s ExecStart/usr/bin/frpc -c /etc/frp/frpc.ini ExecReload/usr/bin/frpc reload -c /etc/frp/frpc.ini [Install] WantedBymulti-user.target启用并启动服务sudo systemctl daemon-reload sudo systemctl enable frpc sudo systemctl start frpc5.2 日志查看技巧实时查看日志journalctl -u frpc -f按时间筛选journalctl -u frpc --since 2024-01-01 --until 2024-01-026. 安全加固方案6.1 连接加密配置在[common]节添加tls_enable true disable_custom_tls_first_byte false6.2 访问控制IP白名单[common] allow_ports 6000-6005,8000-9000API保护[common] authenticate_new_work_conns true6.3 权限最小化建议使用非root用户运行配置文件权限设置为600chmod 600 /etc/frp/frpc.ini7. 常见问题排查指南7.1 连接失败分析症状dial tcp timeout可能原因服务端防火墙未放行端口# 在服务端测试 sudo netstat -tulnp | grep 7000客户端网络出站限制curl -v http://your_frps:70007.2 端口冲突处理修改remote_port为未被占用的端口ss -tulnp | grep 60007.3 性能调优对于高并发场景[common] pool_count 58. 高阶配置技巧8.1 负载均衡配置多台frpc客户端共同提供服务[web] type http local_port 80 custom_domains your.domain.com group web_servers group_key your_group_password8.2 健康检查机制[web] health_check_type http health_check_url /status health_check_interval_s 10 health_check_timeout_s 3 health_check_max_failed 38.3 带宽限制限制单个代理带宽单位MB[ssh] bandwidth_limit 10