---
read_when:
  - 查找 Linux 配套应用状态时
  - 规划平台覆盖或贡献时
summary: Linux 支持 + 配套应用状态
title: Linux 应用
x-i18n:
  generated_at: "2026-02-03T07:52:18Z"
  model: claude-opus-4-5
  provider: pi
  source_hash: a9bbbcecf2fd522a2f5ac8f3b9068febbc43658465bfb9276bff6c3e946789d2
  source_path: platforms/linux.md
  workflow: 15
---

# Linux 应用

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

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

## 新手快速路径（VPS）

1. 安装 Node 22+
2. `npm i -g SKYKOI@latest`
3. `SKYKOI 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](/install/exe-dev)

## 安装

- [入门指南](/start/getting-started)
- [安装与更新](/install/updating)
- 可选流程：[Bun（实验性）](/install/bun)、[Nix](/install/nix)、[Docker](/install/docker)

## Gateway 网关

- [Gateway 网关运行手册](/gateway)
- [配置](/gateway/configuration)

## Gateway 网关服务安装（CLI）

使用以下任一方式：

```
SKYKOI onboard --install-daemon
```

或：

```
SKYKOI gateway install
```

或：

```
SKYKOI configure
```

出现提示时选择 **Gateway service**。

修复/迁移：

```
SKYKOI doctor
```

## 系统控制（systemd 用户单元）

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

最小设置：

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

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

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

[Install]
WantedBy=default.target
```

启用它：

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