DeepSpaceCode VPN 客户端

连接商家算力平台，让服务器通过 VPN 隧道访问你本地的 Ollama/大模型。

前提条件

| 软件 | 说明 | |------|------| | Node.js >= 14 | 下载，装 LTS 版本 | | OpenVPN | 下载社区版，装到默认路径 | | Ollama | 下载，安装并拉取模型 |

安装

npm install -g deepspacecode-vpn

如果下载慢，用国内镜像：

npm install -g deepspacecode-vpn --registry=https://registry.npmmirror.com

快速开始

# 第一步：一键配置系统（需管理员权限）
deepspace-vpn setup

# 第二步：连接
deepspace-vpn connect

# 第三步：查看状态
deepspace-vpn status

setup 会自动完成以下配置：

• 添加防火墙规则，允许 VPN 网段 10.8.0.0/24 访问 Ollama 端口 11434
• 设置系统环境变量 OLLAMA_HOST=0.0.0.0:11434

命令详解

连接

# 交互式输入（推荐）
deepspace-vpn connect

# 命令行传参
deepspace-vpn connect --username zhangsan --password 123456

连接成功后保持运行，按 Ctrl+C 断开。

断开

deepspace-vpn disconnect

查看状态

deepspace-vpn status

显示 VPN 连接状态、Ollama 运行状态、防火墙配置状态。

查看配置

deepspace-vpn config

拉取并显示服务器端配置。

卸载

npm uninstall -g deepspacecode-vpn

更新

npm update -g deepspacecode-vpn

常见问题

提示 "OpenVPN 未安装"

安装 OpenVPN 社区版到默认路径：

• Windows: C:\Program Files\OpenVPN\bin\openvpn.exe
• macOS: brew install openvpn
• Linux: sudo apt-get install openvpn

提示 "需要管理员权限"

防火墙和 OLLAMA_HOST 配置需要管理员权限：

• Windows: 右键以管理员身份运行终端
• macOS/Linux: 前面加 sudo

连接失败

1. 确认账号密码正确（联系商家获取）
2. 确认网络能访问 124.223.14.100:443
3. 运行 deepspace-vpn status 查看状态

Ollama 访问不到

1. 确认 Ollama 正在运行
2. 确认环境变量已设置：echo %OLLAMA_HOST%（Windows）
3. 确认防火墙规则已添加：deepspace-vpn setup
4. 重启 Ollama（改了环境变量后必须重启）

提示 "Node.js 版本过低"

下载安装 Node.js LTS，需要 14 以上版本。