LobeHub私有化部署踩坑记录

技术
发布于 06/10/2026, 02:35 PM2 人读过

部署方法:Docker Compose

参考文档

  1. 在使用官方给的脚本时,可能会遇到网络问题,可以使用SSH反向代理的方式,使用本地PC上的代理服务。

    Termius同样支持端口转发,在主页面有一个Port Forwarding

  2. 在运行部署脚本时,出现了如下错误(参考https://github.com/lobehub/lobehub/issues/15482)

    mc: <ERROR> Unable to set-json anonymous `/bucket.config.json` for `rustfs/lobe`. parse policy failed Error("unknown field `ID`, expected one of `Id`, `Version`, `Statement`", line: 2, column: 6).
    service "rustfs-init" didn't complete successfully: exit 1

解决方法:将lobehub部署目录下bucket.config.json文件中的ID键改为Id

  1. 部署完成后无法上传图片,无法导入数据

    原因:没有配置S3服务的CORS

  2. 上传文件失败

    原因:可能时Nginx配置反代时没有设置S3服务允许的最大文件大小

Nginx反向代理参考配置:

server {
    listen 443 ssl;
    http2 on;
    server_name lobehub.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:3210;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        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;
    }
}
server {
    listen 443 ssl;
    http2 on;
    server_name s3.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        client_max_body_size 500m;

        proxy_pass http://localhost:9000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        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;

        add_header Access-Control-Allow-Origin 'https://lobe.rechx.cn' always;

        if ($request_method = 'OPTIONS') {
            add_header Access-Control-Allow-Origin 'https://lobe.rechx.cn' always;
            add_header Access-Control-Allow-Methods 'GET, PUT' always;
            add_header Access-Control-Allow-Headers 'Content-Type, Authorization, X-Amz-*' always;
            add_header Access-Control-Max-Age 86400 always;
            return 204;
        }
    }
}
  1. 记忆功能出现问题

参考https://github.com/lobehub/lobehub/discussions/15664