> ## Documentation Index
> Fetch the complete documentation index at: https://agdiai-597e782f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux 应用

# Linux 应用

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

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

## 面向初学者的快速路径（VPS）

1. 安装 Node 24（推荐；Node 22 LTS，目前 `22.16+`，为了兼容性仍然可用）
2. `npm i -g agdi@latest`
3. `agdi 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](https://agdiai-597e782f.mintlify.site/install/exe-dev.md)

## 安装

* [入门指南](https://agdiai-597e782f.mintlify.site/start/getting-started.md)
* [安装与更新](https://agdiai-597e782f.mintlify.site/install/updating.md)
* 可选流程：[Bun（实验性）](https://agdiai-597e782f.mintlify.site/install/bun.md)、[Nix](https://agdiai-597e782f.mintlify.site/install/nix.md)、[Docker](https://agdiai-597e782f.mintlify.site/install/docker.md)

## Gateway 网关

* [Gateway 网关运行手册](https://agdiai-597e782f.mintlify.site/gateway.md)
* [配置](https://agdiai-597e782f.mintlify.site/gateway/configuration.md)

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

使用以下任一方式：

```
agdi onboard --install-daemon
```

或者：

```
agdi gateway install
```

或者：

```
agdi configure
```

出现提示时，选择 **Gateway 服务**。

修复/迁移：

```
agdi doctor
```

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

Agdi 默认安装 systemd **用户**服务。对于共享或始终在线的服务器，请使用 **系统** 服务。完整的单元示例和指导
请参见 [Gateway 网关运行手册](https://agdiai-597e782f.mintlify.site/gateway.md)。

最小设置：

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

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

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

[Install]
WantedBy=default.target
```

启用它：

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.