使用命令行安装 Olares
本文介绍如何在 Linux 上使用一行命令行脚本安装 Olares。
安装遇到问题?
如果你在安装过程中遇到问题,欢迎提交 GitHub Issue。提交时请尽量附上以下信息:
- 你使用的平台或环境(例如 Ubuntu、Docker、WSL 等)。
- 安装方式(脚本安装或 Docker 镜像)。
- 详细的错误信息(包括日志、报错信息或截图)。
系统要求
必要配置
- 宿主机要求:
- CPU:4 核及以上。
- 内存:至少 8 GB 可用内存。
- 存储:至少 150 GB 可用磁盘空间。
必须使用 SSD
请勿使用机械硬盘 (HDD)。如果未检测到 SSD,安装将失败。
- 支持的系统:
- Ubuntu 22.04-25.04 LTS
- Debian 12 或 13
可选硬件
安装 Olares 不需要 GPU,但运行 AI 应用需要 GPU支持。
- GPU (仅支持 NVIDIA):
- 架构:Turing 架构或更新版本 (例如 GTX 16 系列、RTX 20 系列)。
- 验证方法:运行
lspci | grep -i nvidia并查看 兼容 GPU 列表。
安装 Olares
在 Linux 命令行中,执行以下命令:
curl -fsSL https://cn.olares.sh | bash -root 用户密码
安装过程中,可能需要输入 root 用户密码。
安装遇到报错?
如果安装过程中出现错误,请先执行以下命令卸载:
olares-cli uninstall --all卸载完成后,重新运行安装命令进行安装。
配置 Wizard
在安装 Olares 的核心服务之前,需要输入在 LarePass 中注册的 Olares ID 前缀。如果你的 Olares ID 为 [email protected],输入 alice123 即可。

安装完成后,屏幕将显示初始系统信息,包括向导地址和初始一次性密码。这些信息在后续激活步骤中会用到。

激活 Olares
使用向导 URL 和初始一次性密码进行激活和 Olares 初始化配置。
在浏览器中输入向导 URL。进入欢迎页面后,按任意键继续。

输入一次性密码,点击继续。

选择系统语言。

选择一个距你所在位置最近的反向代理节点。你也可以之后在 Olares 的更改反向代理页面进行调整。

提示
如果你的 Olares 设备连接的是公网 IP 网络,此步骤会自动跳过。
使用 LarePass 应用激活 Olares。
a. 打开 LarePass 应用,点击扫描二维码,扫描向导页面上的二维码完成激活。
网络要求
为避免激活失败,管理员用户需确保手机和 Olares 设备连接到同一网络。

b. 按照 LarePass 上的提示重置 Olares 的登录密码。
提示
如果你重新安装了 Olares,原有实例将不可用。你可以使用同一个 ID 重新激活 Olares:
设置成功后,LarePass 应用会自动返回主界面,向导页面则会跳转到登录界面。
登录 Olares
在登录页面输入 Olares 登录密码。

系统会要求完成双重验证。你可以选择在 LarePass 上确认登录,或手动输入 6 位验证码。
INFO
验证码有时效限制,请在过期前完成输入。如果验证码过期,需要重新生成。

登录后你就会看到 Olares 桌面。🎉
下一步:安全保存 Olares ID
你已经准备好开始使用 Olares!在此之前,请务必确保 Olares ID 已安全备份。如果不备份,你将无法在需要时恢复 Olares ID。