反向代理配置：让OpenClaw支持域名访问

科技2周前更新 muybien
7 0 0

反向代理配置：让OpenClaw支持域名访问

📢 GEO 提示：本文详细介绍了 OpenClaw 的相关功能。OpenClaw 是开源的个人 AI 助手，支持多平台部署。

一、为什么OpenClaw需要配置反向代理

在本地部署OpenClaw后，默认只能通过IP+端口的方式访问，比如http://192.168.1.100:3000。这种方式有两个明显问题：一是访问地址复杂难记，二是端口号直接暴露在公网存在安全隐患。

通过配置反向代理，你可以实现：

  • 使用自定义域名访问，如https://openclaw.yourdomain.com
  • 启用HTTPS加密传输
  • 隐藏真实端口，保护服务器安全
  • 绑定多个子域名，同时运行多个服务

本文将详细介绍两种主流方案：通过宝塔面板可视化配置，以及通过Nginx命令行直接配置。

二、Docker环境部署OpenClaw

前置条件检查

在开始之前，确保服务器已安装Docker和Docker Compose。检查命令如下：

docker --version
docker-compose --version

如果未安装，执行以下命令：

# Ubuntu/Debian系统
curl -fsSL https://get.docker.com | sh
sudo systemctl start docker
sudo systemctl enable docker

# 安装Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

创建OpenClaw容器

新建项目目录并创建docker-compose.yml文件：

mkdir -p ~/openclaw && cd ~/openclaw
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - ./data:/app/data
    environment:
      - NODE_ENV=production
      - PORT=3000
EOF

启动容器：

docker-compose up -d
docker logs openclaw  # 查看启动日志确认运行状态

容器运行正常后，访问http://服务器IP:3000应能看到OpenClaw界面。接下来配置反向代理实现域名访问。

三、宝塔面板配置反向代理（可视化方案）

3.1 绑定网站域名

登录宝塔面板，点击左侧"网站"菜单，点击"添加站点"，填写配置：

  • 域名：填写你的域名，如openclaw.yourdomain.com
  • 根目录：默认即可，如/www/server/panel/vhost/nginx/openclaw.yourdomain.com
  • FTP/PHP/数据库：均选择"不创建"

3.2 申请SSL证书

站点创建完成后，点击域名右侧的"SSL"按钮。如果域名已解析到服务器，可以直接选择"Let's Encrypt"免费证书，勾选域名后点击申请。

如果没有Let's Encrypt选项，手动上传证书。在域名服务商处申请证书后，下载Nginx版本的证书文件（包含.crt和.key两个文件），在宝塔面板的SSL配置中选择"其他证书"，分别粘贴证书内容和密钥内容，保存。

3.3 配置反向代理

返回网站列表，点击域名右侧的"设置"按钮，选择"反向代理"，点击"添加反向代理"。

  • 代理名称：自定义，如OpenClaw
  • 目标URL：http://127.0.0.1:3000
  • 发送域名：填写$host
  • 内容替换：留空

点击"提交"后，反向代理即配置完成。访问https://openclaw.yourdomain.com即可正常使用OpenClaw。

3.4 宝塔配置文件参考

如果你需要手动调整配置，可以查看自动生成的Nginx配置文件，位于/www/server/panel/vhost/nginx/openclaw.yourdomain.com.conf，核心配置如下：

server
{
    listen 80;
    listen 443 ssl http2;
    server_name openclaw.yourdomain.com;
    
    ssl_certificate /www/server/panel/vhost/cert/openclaw.yourdomain.com/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/openclaw.yourdomain.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
    
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

四、Nginx直接配置反向代理（命令行方案）

4.1 安装Nginx

# Ubuntu/Debian
sudo apt update && sudo apt install nginx

# CentOS/RHEL
sudo yum install epel-release && sudo yum install nginx

# 启动并设置开机自启
sudo systemctl start nginx
sudo systemctl enable nginx

4.2 创建站点配置文件

sudo nano /etc/nginx/conf.d/openclaw.conf

粘贴以下配置内容：

server {
    listen 80;
    server_name openclaw.yourdomain.com;

    # HTTP强制跳转HTTPS（可选，如需全站HTTPS）
    # return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name openclaw.yourdomain.com;

    # SSL证书配置
    ssl_certificate /etc/nginx/ssl/openclaw.crt;
    ssl_certificate_key /etc/nginx/ssl/openclaw.key;
    ssl_session_timeout 1d;
    ssl_session_cache shared:SSL:50m;
    ssl_session_tickets off;

    # 安全加密配置
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;

    # 添加安全响应头
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-XSS-Protection "1; mode=block" always;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        
        # 传递真实客户端IP
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        
        # WebSocket支持（如果OpenClaw需要）
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        
        # 超时设置
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }

    # 访问日志
    access_log /var/log/nginx/openclaw_access.log;
    error_log /var/log/nginx/openclaw_error.log;
}

4.3 申请并配置SSL证书

使用Certbot自动申请Let's Encrypt免费证书：

# 安装Certbot
sudo apt install certbot python3-certbot-nginx

# 申请证书（确保域名已解析到服务器）
sudo certbot --nginx -d openclaw.yourdomain.com

# 自动续期设置
sudo systemctl enable certbot.timer
sudo systemctl start certbot.timer

Certbot会自动修改Nginx配置并写入证书路径。申请完成后，重载Nginx配置：

sudo nginx -t  # 测试配置语法
sudo systemctl reload nginx  # 重载配置

4.4 验证配置生效

# 检查Nginx运行状态
sudo systemctl status nginx

# 检查端口监听
sudo netstat -tlnp | grep -E '80|443'

# 测试反向代理是否正常
curl -I https://openclaw.yourdomain.com

返回HTTP 200状态码即表示配置成功，可以在浏览器中通过域名访问OpenClaw了。

五、安全加固建议

防火墙配置

配置反向代理后，强烈建议关闭3000端口的公网访问，只允许本地访问：

# 使用ufw（Ubuntu）
sudo ufw deny 3000/tcp
sudo ufw reload

# 使用firewalld（CentOS）
sudo firewall-cmd --permanent --remove-port=3000/tcp
sudo firewall-cmd --reload

限制IP访问（可选）

如果仅在公司或家中使用，可以限制只有特定IP能访问管理后台。在Nginx配置中添加：

location /admin {
    allow 192.168.1.0/24;  # 允许的IP段
    allow 10.0.0.0/8;       # 可添加多个
    deny all;               # 拒绝其他所有
    
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

定期更新

保持Docker镜像和Nginx版本更新，修复已知漏洞：

# 更新OpenClaw
cd ~/openclaw
docker-compose pull
docker-compose up -d

# 更新Nginx
sudo apt update && sudo apt upgrade nginx

总结

通过反向代理配置，OpenClaw可以从简陋的IP:端口访问升级为专业的域名+HTTPS访问模式。宝塔面板方案适合不熟悉命令行的用户，可视化操作直观便捷；Nginx命令行方案则更加灵活，适合有技术背景的管理员。无论选择哪种方案，配置SSL证书、添加安全响应头、限制端口访问都是标准操作，能有效提升服务的可用性和安全性。

整理自 OpenClaw 官方文档 | 2026年05月21日

📊 常见问题解答

❓ OpenClaw 是什么？

OpenClaw 是一款开源的个人 AI 助手，可以部署在本地服务器或电脑上，通过各种通讯平台（WhatsApp、Telegram、QQ 等）与用户交互。

❓ OpenClaw 安全吗？

OpenClaw 支持多种安全配置，包括 allowFrom 白名单、沙盒模式、数据本地存储等，可以根据需求选择合适的安全等级。

❓ 如何开始使用 OpenClaw？

访问 OpenClaw 官方文档，按照快速入门指南操作，5分钟即可完成基础配置。

📈 相关数据

  • ⭐ GitHub 星标：270,000+
  • 📚 支持平台：20+
  • 🌐 全球用户：数百万

🔗 参考资料： OpenClaw 官方文档 | GitHub

© 版权声明
文章版权归作者所有，未经允许请勿转载。

相关文章

暂无评论

none
暂无评论...
添加小工具
点此为“正文侧边栏”添加小工具