Ubuntu/Debian UFW)

关于AI小龙虾（OpenClaw）安装后的访问控制设置，由于这是一个开源项目，具体配置取决于您的部署环境和需求,以下是通用访问控制建议：

基础网络访问控制

防火墙配置

sudo ufw allow 8000/tcp  # 假设OpenClaw运行在8000端口
sudo ufw enable
# CentOS/RHEL (firewalld)
sudo firewall-cmd --permanent --add-port=8000/tcp
sudo firewall-cmd --reload

仅限内网访问

# 在OpenClaw配置文件中指定监听地址
host = '192.168.1.100'  # 内网IP
# 或
host = '127.0.0.1'  # 仅本地访问

应用层访问控制

身份认证配置

# config/security.yaml 示例
authentication:
  enabled: true
  providers:
    - type: jwt
      secret_key: "your-secret-key-here"
    - type: basic_auth
      users:
        - username: admin
          password_hash: "$2b$12$..."
# API访问限制
rate_limit:
  requests_per_minute: 60
  ip_whitelist:
    - 192.168.1.0/24

API密钥管理

# 生成API密钥
python manage.py generate_api_key --user admin
# .env文件配置
API_KEYS_ENABLED=true
REQUIRE_API_KEY_FOR=/api/v1/*

Docker部署安全设置

Docker Compose安全配置

version: '3.8'
services:
  openclaw:
    build: .
    ports:
      - "127.0.0.1:8000:8000"  # 只绑定到本地
    environment:
      - ALLOWED_HOSTS=yourdomain.com,localhost
      - CSRF_TRUSTED_ORIGINS=https://yourdomain.com
    networks:
      - internal_network
networks:
  internal_network:
    internal: true  # 内部网络，外部无法直接访问

使用反向代理（Nginx）

# nginx.conf
server {
    listen 80;
    server_name yourdomain.com;
    location / {
        # 添加基础认证
        auth_basic "Restricted Access";
        auth_basic_user_file /etc/nginx/.htpasswd;
        # IP白名单
        allow 192.168.1.0/24;
        allow 10.0.0.0/8;
        deny all;
        proxy_pass http://localhost:8000;
        proxy_set_header Host $host;
    }
}

具体配置步骤

步骤1：查看OpenClaw配置文件

# 通常位于：
# - config/settings.py
# - .env
# - config.yaml

步骤2：设置环境变量

# 创建.env文件
cat > .env << EOF
SECRET_KEY=your-secure-secret-key
DEBUG=false
ALLOWED_HOSTS=.yourdomain.com,localhost,127.0.0.1
CORS_ALLOWED_ORIGINS=https://yourdomain.com
ENABLE_AUTH=true
EOF

步骤3：启用访问日志

# logging.conf
[loggers]
keys=root,access
[logger_access]
level=INFO
handlers=access_file
qualname=access
propagate=0
[handler_access_file]
class=handlers.RotatingFileHandler
args=('logs/access.log', 'a', 10485760, 5)
formatter=access

最佳实践建议

1. 最小权限原则

   • 使用专用用户运行服务
   • 限制文件系统访问权限

2. 定期审计

   # 检查异常访问
   grep "Failed login" /var/log/openclaw/access.log
   # 监控API使用
   python tools/monitor_api_usage.py

3. 更新与维护

   • 定期更新OpenClaw版本
   • 审查依赖包安全性

故障排查

如果访问控制失效：

# 1. 检查服务绑定
netstat -tlnp | grep 8000
# 2. 验证防火墙规则
sudo iptables -L -n -v
# 3. 查看应用日志
tail -f /var/log/openclaw/error.log

注意：具体配置路径和选项请参考OpenClaw项目的官方文档，建议查阅项目中的 SECURITY.md、CONFIGURATION.md 等文档获取最准确的配置信息。

标签： UFW Ubuntu