准备系统环境
服务器准备
最低配置：2c4g
推荐配置：4c8g
本文使用Debain13 2c4g演示
=== 系统信息 ===
PRETTY_NAME="Debian GNU/Linux 13 (trixie)"
VERSION_ID="13"
=== CPU 核心数 ===
2
=== 内存信息 ===
Mem: 3.8Gi 339Mi 3.6Gi 736Ki 111Mi 3.5Gi
=== 硬盘容量 ===
/dev/sda1 20G 1.1G 18G 6% /
/dev/sda15 124M 8.7M 116M 8% /boot/efiDocker环境准备
如果没装Docker和Docker Compose 可以用一下命令一键安装一下
bash <(wget -qO- https://xuanyuan.cloud/docker.sh)选择 1 自动安装Docker
root@LobeHub:~# bash <(wget -qO- https://xuanyuan.cloud/docker.sh)
✅ 检测到 sudo 命令
==========================================
🐳 欢迎使用轩辕镜像 Docker 一键安装配置脚本
==========================================
官方网站: https://xuanyuan.cloud/
请选择操作模式：
1) 一键安装配置（推荐）
2) 修改轩辕镜像专属域名
3) 恢复 Docker 镜像相关配置
请输入选择 [1/2/3]: 1确认信息
root@LobeHub:~# docker --version
Docker version 29.5.3, build d1c06ef
root@LobeHub:~# docker compose version
Docker Compose version v5.1.4LobeHub 安装
系统兼容性说明
支持 Unix 环境（Linux/macOS）的一键部署
Windows 用户需通过 WSL 2 运行
一键启动脚本为首次部署专用，非首次部署请参考 自定义部署 章节
端口占用检查：确保
3210、9000、9001端口可用
执行以下命令初始化部署环境，目录 lobehub 将用于存放你的配置文件和后续的数据库文件。
mkdir lobehub && cd lobehub获取并执行部署脚本：
bash <(curl -fsSL https://lobe.li/setup.sh) -l zh_CN脚本支持以下部署模式，请根据你的需求选择相应的模式，并继续阅读文档的剩余部分。
本地模式（默认）：仅能在本地访问，不支持局域网 / 公网访问，适用于初次体验；
端口模式：支持局域网 / 公网的
http访问，适用于无域名或内部办公场景使用；域名模式：支持局域网 / 公网在使用反向代理下的
http/https访问，适用于个人或团队日常使用；
在脚本的选项提示 (选项1/选项2)[选项1] 中：(选项1 / 选项2) 代表可以选择的选项，[选项1]代表默认选项，直接回车即可选择默认选项。
本地模式
在交互式脚本中完成剩余配置
持续回车采用默认配置。
查看配置生成报告
你需要在脚本运行结束后查看配置生成报告，包括各服务的访问地址和密码。
安全密钥生成结果如下：LobeHub: - URL: http://localhost:3210RustFS: - URL: http://localhost:9000 - Username: admin - Password: 8c82ea41启动 Docker
docker compose up -d检查日志
docker logs -f lobehub如果你在容器中看到了以下日志，则说明已经启动成功：
[Database] Start to migration...✅ database migration pass.------------------------------------- ▲ Next.js 16.x.x - Local: http://localhost:3210 - Network: http://0.0.0.0:3210 ✓ Starting... ✓ Ready in 95ms访问应用
通过 http://localhost:3210 访问你的 LobeHub 服务。
端口模式
在交互式脚本中完成剩余配置
在端口模式中，你需要根据脚本提示完成：
服务器 IP 地址设置：以便局域网 / 公网访问。
安全密钥重新生成：我们强烈建议你重新生成安全密钥，如果你缺少脚本所需的密钥生成库，我们建议你参考 自定义部署 章节对密钥进行修改。
查看配置生成报告
你需要在脚本运行结束后查看配置生成报告，包括各服务的访问地址和密码。
安全密钥生成结果如下：LobeHub: - URL: http://your_server_ip:3210RustFS: - URL: http://your_server_ip:9000 - Username: admin - Password: dbac8440启动 Docker
docker compose up -d检查日志
docker logs -f lobehub如果你在容器中看到了以下日志，则说明已经启动成功：
[Database] Start to migration...✅ database migration pass.------------------------------------- ▲ Next.js 16.x.x - Local: http://your_server_ip:3210 - Network: http://0.0.0.0:3210 ✓ Starting... ✓ Ready in 95ms访问应用
你可以通过 http://your_server_ip:3210 访问你的 LobeHub 服务。
域名模式
完成反向代理配置
在域名模式中，你需要完成反向代理配置，并确保局域网 / 公网能访问到以下服务。请使用反向代理将以下服务端口映射到域名：
在交互式脚本中完成剩余配置
在域名模式中，你需要根据脚本提示完成：
LobeHub 服务的域名设置：
lobe.example.comS3 服务的域名设置：
s3.example.com选择访问协议：
http或https安全密钥重新生成：我们强烈建议你重新生成安全密钥，如果你缺少脚本所需的密钥生成库，我们建议你参考 自定义部署 章节对密钥进行修改。
单域名部署方案 如果只有一个域名，可以通过不同端口区分服务：
LobeHub 服务的域名设置：
lobe.example.com:${PORT1}S3 服务的域名设置：
lobe.example.com:${PORT2}需在反向代理中配置对应端口的转发规则。 端口模式 vs 域名模式：端口模式：一键安装脚本自动使用默认端口（3210/9000/9001）
域名模式：可自定义端口（通过反向代理配置）
以下问题可能导致你的服务无法正常访问：
此处的域名配置需要与步骤
1中的反向代理配置保持一致。如果你使用 Cloudflare 的域名解析服务并开启了
全程代理，请使用https协议。如果你使用了 HTTPS 协议，请确保你的域名证书已经正确配置，一键部署默认不支持自签发证书。
查看配置生成报告
你需要在脚本运行结束后查看配置生成报告，包括各服务的访问地址和密码。
安全密钥生成结果如下：LobeHub: - URL: https://lobe.example.comRustFS: - URL: https://s3.example.com - Username: admin - Password: dbac8440启动 Docker
docker compose up -d检查日志
docker logs -f lobehub如果你在容器中看到了以下日志，则说明已经启动成功：
[Database] Start to migration...✅ database migration pass.------------------------------------- ▲ Next.js 16.x.x - Local: https://localhost:3210 - Network: http://0.0.0.0:3210 ✓ Starting... ✓ Ready in 95ms访问应用
你可以通过 https://lobe.example.com 访问你的 LobeHub 服务。