Linux 应用

Gateway 网关在 Linux 上完全支持。Node 是推荐的运行时。 不推荐 Bun 用于 Gateway 网关（WhatsApp/Telegram 存在 bug）。

原生 Linux 配套应用已在计划中。如果你想帮助构建，欢迎贡献。

新手快速路径（VPS）

1. 安装 Node 22+
2. npm i -g opensoul@latest
3. opensoul onboard --install-daemon
4. 从你的笔记本电脑：ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
5. 打开 http://127.0.0.1:18789/ 并粘贴你的令牌

分步 VPS 指南：exe.dev

安装

• 入门指南
• 安装与更新
• 可选流程：Bun（实验性）、Nix、Docker

Gateway 网关

• Gateway 网关运行手册
• 配置

Gateway 网关服务安装（CLI）

使用以下任一方式：

opensoul onboard --install-daemon

或：

opensoul gateway install

或：

opensoul configure

出现提示时选择 Gateway service。

修复/迁移：

opensoul doctor

系统控制（systemd 用户单元）

OpenSoul 默认安装 systemd 用户服务。对于共享或常驻服务器使用系统 服务。完整的单元示例和指南 在 Gateway 网关运行手册 中。

最小设置：

创建 ~/.config/systemd/user/opensoul-gateway[-<profile>].service：

[Unit]
Description=OpenSoul Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/opensoul gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

启用它：

systemctl --user enable --now opensoul-gateway[-<profile>].service