Runixo

Appearance

常见问题 ​

安装相关 ​

Agent 安装失败 ​

Q: 一键脚本安装报错 Permission denied

需要 root 权限：

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

Q: 安装后 Agent 没有启动

检查 systemd 服务状态：

bash
sudo systemctl status runixo-agent
sudo journalctl -u runixo-agent -n 50

Q: 支持哪些操作系统？

Agent 支持 Linux amd64 和 arm64。客户端支持 Windows 10+、macOS 11+、Linux。暂不支持 Windows Server 上运行 Agent。

客户端安装问题 ​

Q: macOS 提示"无法验证开发者"

bash
# 方法一：系统偏好设置 → 安全性与隐私 → 仍要打开
# 方法二：
xattr -cr /Applications/Runixo.app

Q: Linux AppImage 无法运行

bash
chmod +x Runixo-x.x.x.AppImage
# 如果缺少 FUSE
sudo apt install libfuse2

连接相关 ​

无法连接服务器 ​

Q: 连接超时

  1. 检查服务器防火墙是否开放 gRPC 端口（默认 50051）：
bash
sudo ufw allow 50051/tcp
# 或
sudo firewall-cmd --add-port=50051/tcp --permanent
sudo firewall-cmd --reload
  1. 检查 Agent 是否在运行：
bash
sudo systemctl status runixo-agent
  1. 检查端口是否在监听：
bash
ss -tlnp | grep 50051

Q: 证书错误

自签名证书需要在客户端导入。详见 TLS 证书管理。

Q: Token 错误

查看正确的 Token：

bash
sudo runixo info

Token 区分大小写，请完整复制。

连接断开 ​

Q: 连接频繁断开

  • 检查网络稳定性
  • 检查服务器负载是否过高
  • 查看 Agent 日志是否有错误：sudo journalctl -u runixo-agent -f

Docker 相关 ​

Q: Docker 功能不可用

确保 Agent 有权限访问 Docker socket：

bash
# 检查 Docker 是否安装
docker --version

# 检查 socket 权限
ls -la /var/run/docker.sock

# 如果 Agent 不是 root 运行，添加到 docker 组
sudo usermod -aG docker runixo
sudo systemctl restart runixo-agent

Q: 容器日志加载很慢

大量日志时可能较慢，建议：

  • 使用日志过滤功能
  • 限制日志时间范围
  • 配置容器日志轮转

AI 相关 ​

Q: AI 功能没有响应

  1. 检查是否配置了 AI 模型和 API Key
  2. 检查网络是否能访问 AI 服务商 API
  3. 查看客户端开发者工具（Ctrl+Shift+I）中的错误信息

Q: AI 回答不准确

  • 尝试更换更强的模型（如 gpt-4o）
  • 提供更具体的问题描述
  • 确保 AI 有足够的上下文（选中相关服务器）

Q: API Key 安全吗？

API Key 使用系统级加密存储（Windows DPAPI / macOS Keychain / Linux libsecret），不会以明文保存。

插件相关 ​

Q: 插件安装后不生效

  • 重启客户端
  • 检查插件是否兼容当前客户端版本
  • 查看插件日志

Q: 如何卸载插件

在 「插件」 页面找到插件，点击 「卸载」。

更新相关 ​

Q: Agent 如何更新？

Agent 支持自动更新检查。也可以手动更新：

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

Q: 客户端如何更新？

客户端会自动检查更新并提示。也可以从 Releases 下载最新版本。

性能相关 ​

Q: Agent 占用多少资源？

  • CPU：空闲时 < 1%，操作时短暂升高
  • 内存：~20-30MB
  • 磁盘：~15MB（二进制）+ 配置和日志

Q: 能管理多少台服务器？

客户端没有硬性限制。实际取决于你的网络和客户端机器性能，通常管理 50+ 台服务器没有问题。

MIT License

© 2026 Runixo