快速开始

本指南帮助你在 5 分钟内完成 Runixo 的安装和首次连接。

下载客户端

从 GitHub Releases 下载对应平台的安装包：

平台	文件	说明
Windows	Runixo-Setup-x.x.x.exe	双击安装
macOS	Runixo-x.x.x.dmg	拖入 Applications
Linux	Runixo-x.x.x.AppImage	chmod +x 后运行

安装 Agent

方式一：SSH 自动安装（推荐）

在客户端中完成所有操作，无需手动 SSH：

1. 打开客户端，进入 「服务器」 页面
2. 点击 「SSH 安装」
3. 填写服务器连接信息：
   • 主机地址（IP 或域名）
   • SSH 端口（默认 22）
   • 用户名（需要 root 或 sudo 权限）
   • 密码或密钥
4. 点击 「开始安装」

安装过程自动完成：

• 下载对应架构的 Agent 二进制
• 创建 systemd 服务
• 生成 TLS 证书
• 启动 Agent 并配置开机自启
• 自动将服务器添加到客户端

方式二：一键脚本安装

在服务器上执行：

curl -fsSL https://raw.githubusercontent.com/Zhang142857/runixo/main/scripts/install.sh | sudo bash

安装完成后查看连接信息：

sudo runixo info

输出示例：

Runixo Agent v1.0.0
Status:    running
gRPC Port: 50051
Token:     rxa_3f8b2c...
TLS Cert:  /etc/runixo/cert.pem

方式三：手动安装

# 1. 下载二进制
wget https://github.com/Zhang142857/runixo/releases/latest/download/runixo-agent-linux-amd64.tar.gz

# 2. 解压
tar -xzf runixo-agent-linux-amd64.tar.gz

# 3. 安装到系统
sudo mv runixo-agent /usr/local/bin/
sudo chmod +x /usr/local/bin/runixo-agent

# 4. 初始化配置
sudo runixo-agent init

# 5. 启动
sudo systemctl start runixo-agent
sudo systemctl enable runixo-agent

连接服务器

自动连接（SSH 安装后）

SSH 安装方式会自动完成连接，无需额外操作。

手动连接

1. 打开客户端，进入 「服务器」 页面
2. 点击 「添加服务器」
3. 填写连接信息：
   • 名称：自定义名称（如 生产服务器-1）
   • 地址：服务器 IP 或域名
   • 端口：gRPC 端口（默认 50051）
   • Token：Agent 生成的认证 Token
4. 点击 「连接」

证书问题？

如果连接失败提示证书错误，需要导入 Agent 的 TLS 证书：

1. 从服务器下载 /etc/runixo/cert.pem
2. 在客户端连接界面点击 「导入证书」
3. 选择下载的证书文件

详见 TLS 证书管理

验证连接

连接成功后，你应该能看到：

• ✅ 服务器状态：在线
• ✅ 系统信息：操作系统、内核版本、运行时间
• ✅ 实时监控：CPU、内存、磁盘、网络图表
• ✅ 终端：可以直接在客户端执行命令

下一步

• 配置参考 — 自定义 Agent 行为
• Docker 管理 — 管理容器和镜像
• AI 功能 — 使用 AI 辅助运维
• 插件系统 — 安装和开发插件