reasonix-remote-linux-setuplisted

# Reasonix Linux 远程主机部署与桌面版远程连接 在 Linux 远程主机（含绿联 NAS 等容器化/魔改系统）上安装配置 reasonix，并通过 web 端 / Windows 桌面版远程查看使用。基于 2026-08 绿联 DX4600PRO（Debian 12, x86_64）实战验证。 ## 1. 安装二进制 ```bash # 下载官方 Linux 包（GitHub release: esengine/DeepSeek-Reasonix） # 国内网络：本机走代理下载后 scp 上传，或远程 curl 走 gh-proxy.com 镜像 # https://gh-proxy.com/https://github.com/esengine/DeepSeek-Reasonix/releases/download/<tag>/Reasonix-linux-amd64.tar.gz mkdir -p ~/reasonix && cd ~/reasonix tar -xzf Reasonix-linux-amd64.tar.gz # 解出 reasonix / reasonix-desktop 等 chmod +x reasonix ./reasonix version ``` **⚠️ 必须加入 PATH**：桌面版 remote bootstrap 用 `command -v reasonix` 检测远程是否已装，检测不到就尝试下载（直连 GitHub 易失败）→ 连接报「无法连接」。 ```bash sudo ln -s ~/reasonix/reasonix /usr/local/bin/reasonix # 验证：command -v reasonix && reasonix serve --help | grep port-file # 需支持 --port-file ``` ## 2. 配置（~/.reasonix/） - `~/.reasonix/config.toml`：`default_model` + `[[providers]]`（name/kind/base_url/models/api_key_env）+ `[serve]` 段 - `~/.reasonix/.env`：API key（`chmod 600`）；provider 只存 env 变量名，密钥在 .env - **无 bubblewrap 的容器系统必须 `[sandbox] bash = "off"`**，否则 v1.16+ 拒绝执行 shell 命令（绿联 NAS 无 bwrap） - serve 认证（公网暴露必须）： ```bash ./reasonix serve --hash-password --password '密码' # 生成 bcrypt hash # config.toml: # [serve] # auth_mode = "password" # password_hash = "$2a$12$..." ``` ## 3. 启动 serve（常驻） ```bash cd ~/reasonix setsid nohup ./reasonix serve --addr 0.0.0.0:8787 > ~/reasonix/serve.log 2>&1 < /dev/null & ``` 验证：`curl http://IP:8787/login` 得登录页；POST