当前位置：首页 > news >正文

FRP + Caddy 域名HTTPS配置指南

news 2026/8/27 10:13:03

FRP + Caddy 域名HTTPS配置指南

本指南提供使用FRP内网穿透配合Caddy反向代理实现域名访问和HTTPS加密的完整配置方案

📋 目录

项目概览
准备工作
FRP配置
Caddy配置
服务管理
验证测试

项目概览

本方案通过以下组件实现内网服务的外网访问：

用户访问 [域名] --HTTPS--> [Caddy服务器] --TCP代理--> [FRP服务端] --内网穿透--> [FRP客户端] --> [本地服务]

架构说明

Caddy服务器: 处理域名解析、HTTPS证书自动生成和反向代理
FRP服务端: 运行在Caddy服务器的7000端口，负责内网穿透连接
FRP客户端: 运行在openclaw服务器，连接到FRP服务端
服务端口映射: 本地18789端口 → 外网18089端口

准备工作

软件下载

FRP下载

下载地址: https://github.com/fatedier/frp/releases
建议版本: 选择最新稳定版本

Caddy下载

下载地址: https://github.com/caddyserver/caddy/releases
官方文档: https://caddyserver.com/docs

服务器要求

Caddy服务器(公网服务器)
- 具有公网IP和域名
- 开放80、443、7000、18089端口
Openclaw服务器(内网服务器)
- 能够访问Caddy服务器
- 本地服务运行在18789端口

FRP配置

1. FRP客户端配置 (openclaw服务器)

创建配置文件frpc.toml：

# frpc.toml - FRP客户端配置文件 # FRP服务端地址 serverAddr = "你的Caddy服务器公网IP或域名" # FRP服务端监听端口 serverPort = 7000 # 代理配置 [[proxies]] # 代理名称 name = "openclaw" # 代理类型 # tcp: TCP协议转发，适用于大多数场景 # http: HTTP协议转发 # https: HTTPS协议转发 # stcp: 安全的TCP内网穿透 # sudp: UDP协议转发 # xtcp: P2P的TCP内网穿透 # httpProxy: HTTP代理转发 # httpsProxy: HTTPS代理转发 # tcpPort: 端口复用器，可以为指定的本地服务分配一个空闲的远程端口 # https2http: TLS over HTTPS to HTTP反向代理 # https2https: TLS over HTTPS to HTTPS反向代理 # pluginUnixDomainSocket: Unix Domain Socket # pluginHTTPProxy: HTTP代理插件 # pluginSocks5: SOCKS5代理插件 # pluginStaticFile: 静态文件代理插件 # pluginHTTP2HTTPS: HTTP to HTTPS反向代理 # pluginHTTPS2HTTP: HTTPS to HTTP反向代理 # plugin55: 插件支持更多的自定义转发规则 # pluginTLS: TLS层代理插件 type = "tcp" # 本地服务IP地址 localIP = "127.0.0.1" # 本地服务端口 localPort = 18789 # 远程映射端口 remotePort = 18089

2. FRP服务端配置 (Caddy服务器)

创建配置文件frps.toml：

# frps.toml - FRP服务端配置文件 # 服务端监听端口，用于接收客户端连接 bindPort = 7000 # HTTP虚拟主机监听端口 vhostHTTPPort = 80 # 以下是可选配置项，根据需要添加： # 服务端Token验证 (建议生产环境启用) # token = "your_auth_token" # 连接池大小 # poolCount = 5 # 是否启用HTTP虚拟主机路由 # vhostHTTPPort = 80 # vhostHTTPSPort = 443 # 日志配置 # log.to = "./frps.log" # log.level = "info" # log.maxDays = 3 # 允许代理绑定的端口范围 # allowPorts = [ # { start = 18080, end = 19080 }, # { start = 20000, end = 20500 }, # ]

3. FRP服务配置文件

创建systemd服务文件/etc/systemd/system/frp.service：

[Unit] Description=FRP Service After=network.target [Service] Type=simple User=root WorkingDirectory=/usr/local/frp/frp版本号 ExecStart=/usr/local/frp/frp版本号/frpc -c /usr/local/frp/frp版本号/frpc.toml Restart=on-failure LimitNOFILE=65536 [Install] WantedBy=multi-user.target

注意:
如果是Caddy服务器，请将frpc改为frps，配置文件改为frps.toml
请将路径/usr/local/frp/frp版本号替换为实际的frp安装路径

Caddy配置

1. Caddy安装步骤

# 1. 下载并解压cd/usr/local/bintar-xzfcaddy.tar.gzchmod+x caddy# 2. 验证安装caddy version# 3. 创建必要的目录mkdir-p/etc/caddymkdir-p/var/lib/caddymkdir-p/var/log/caddy# 4. 防火墙设置 (如果启用防火墙)firewall-cmd--permanent--add-service=http firewall-cmd--permanent--add-service=https firewall-cmd--reload

2. Caddyfile配置

创建配置文件/etc/caddy/Caddyfile：

{ # 禁用HTTPS重定向，让Caddy自动处理证书 auto_https disable_redirects } # 你的域名配置 你的域名.com { # 反向代理配置 reverse_proxy 127.0.0.1:18089 { # flush_interval -1: 禁用缓冲，实时传输数据 flush_interval -1 # 传递客户端真实信息到后端 header_up Host {host} header_up X-Real-IP {remote_host} header_up X-Forwarded-For {remote_host} header_up X-Forwarded-Proto {scheme} } # WebSocket支持 (如果需要) @websockets { header Connection *Upgrade* header Upgrade * } handle @websockets { reverse_proxy 127.0.0.1:18089 { flush_interval -1 } } # 日志配置 log { output file /var/log/caddy/lshclaw-access.log format console } # 可选: 访问控制 # @blocked { # not remote_ip 192.168.1.0/24 # not remote_ip 10.0.0.0/8 # } # abort @blocked } # 备用配置: 通配符域名支持 # *.你的域名.com { # reverse_proxy 127.0.0.1:18089 { # flush_interval -1 # header_up Host {host} # header_up X-Real-IP {remote_host} # header_up X-Forwarded-For {remote_host} # header_up X-Forwarded-Proto {scheme} # } # # log { # output file /var/log/caddy/wildcard-access.log # format console # } # }

3. Caddy服务配置

创建systemd服务文件/etc/systemd/system/caddy.service：

[Unit] Description=Caddy Documentation=https://caddyserver.com/docs/ After=network.target network-online.target Wants=network-online.target [Service] User=root Group=root # 启动命令 ExecStart=/usr/local/bin/caddy run --environ \ --config /etc/caddy/Caddyfile \ --adapter caddyfile # 重载命令 ExecReload=/usr/local/bin/caddy reload \ --config /etc/caddy/Caddyfile \ --adapter caddyfile TimeoutStopSec=5s LimitNOFILE=1048576 LimitNPROC=512 PrivateTmp=true ProtectSystem=full AmbientCapabilities=CAP_NET_BIND_SERVICE Restart=on-failure RestartSec=5s [Install] WantedBy=multi-user.target

服务管理

1. FRP服务管理脚本

创建重启脚本restart_frp.sh：

#!/bin/bash# FRP 一键重启脚本 - 适配 systemd 系统服务echo"==================== 正在重启 FRP 服务 ===================="# 标准重启系统服务（自动停止+启动，无需手动处理进程）systemctl restart frp# 加载服务配置（如果你改过frp.service，执行这个）systemctl daemon-reloadecho"==================== 查看 FRP 运行状态 ===================="# 显示服务状态，确认是否启动成功systemctl status frpecho"==================== FRP 重启完成！ ===================="

2. Caddy服务管理脚本

创建重启脚本restart_caddy.sh：

#!/bin/bashecho"==================== 正在重启 caddy 服务 ===================="systemctl daemon-reload systemctl restart caddyecho"==================== 查看 caddy 运行状态 ===================="systemctl status caddyecho"==================== caddy 重启完成！ ===================="

3. 常用服务管理命令

# 设置开机自启systemctlenablefrp# Openclaw服务器systemctlenablecaddy# Caddy服务器# 启动服务systemctl start frp systemctl start caddy# 停止服务systemctl stop frp systemctl stop caddy# 查看服务状态systemctl status frp systemctl status caddy# 查看日志journalctl-ufrp-fjournalctl-ucaddy-f# 查看Caddy实时日志tail-f/var/log/caddy/lshclaw-access.log

验证测试

1. 服务状态检查

# 检查FRP服务psaux|grepfrpnetstat-tlnp|grep:7000# 检查7000端口netstat-tlnp|grep:18089# 检查18089端口# 检查Caddy服务psaux|grepcaddynetstat-tlnp|grep:80netstat-tlnp|grep:443

2. 连通性测试

# 测试域名解析nslookup你的域名.com# 测试HTTPS访问curl-Ihttps://你的域名.com# 测试WebSocket连接wscat-cwss://你的域名.com

3. 故障排除

常见问题：

证书获取失败
- 确保域名正确解析到服务器IP
- 检查80端口是否开放（用于ACME验证）
- 查看Caddy日志：journalctl -u caddy -f
连接超时
- 检查FRP服务端是否正常运行
- 确认防火墙规则正确
- 验证FRP客户端能否连接到服务端
- 检查网络连通性：ping、telnet
502 Bad Gateway
- 确认FRP客户端localIP和localPort配置正确
- 检查本地服务是否正常运行
- 查看FRP连接状态
WebSocket连接失败
- 确保Caddy配置包含WebSocket支持
- 检查flush_interval设置
- 验证后端服务支持WebSocket