不在公网开端口、不写死配置:我在 Linux VPS 上部署 Paseo 手机控制 Claude Code 的极客实践

01

绝对的零入站暴露：Paseo 本地守护进程必须仅监听回环地址 127.0.0.1:6767。服务器防火墙不需要为 Paseo 开放任何 TCP 入站端口，也不需要额外搭建 Tailscale VPN 或 Nginx 反代。

02

端到端加密出站 Relay：手机客户端与服务器的通信，完全依赖 Paseo daemon 主动向官方 Relay 发起的出站加密 WebSocket 连接。流量全程端到端加密（E2EE），公网攻击面被物理降噪到极致。

03

坚持非 root 最小权限：daemon 必须使用日常开发使用的普通用户身份运行，直接复用该用户现有的 SSH 密钥代理、Git 提交身份、Skills 和 MCP 工具链。

服务器本地运行 Claude Code / Codex (普通用户身份)

　　　　↓ (本地 IPC / PTY)

Paseo Daemon (只监听 127.0.0.1:6767)

　　　　↓ (主动出站 WSS 连接)

Paseo 官方 E2EE Relay

　　　　↓ (加密流式同步)

手机 Paseo 客户端 (实时查看、审批权限、追加 Prompt)

mkdir -p ~/.local/bin

cat << 'WRAPPER_EOF' > ~/.local/bin/paseo-claude

#!/bin/bash

set -euo pipefail

　# 1. 定位并读取用户当前的 Claude 配置文件

SETTINGS_FILE="${HOME}/.claude/settings.json"

　# 2. 如果存在自定义 env 配置，动态注入到当前进程环境中

if [[ -f "$SETTINGS_FILE" ]]; then

　eval "$(node -e '

　　try {

　　　const s = require(process.env.SETTINGS_FILE);

　　　if (s.env) {

　　　　for (const [k, v] of Object.entries(s.env)) {

　　　　　console.log(`export ${k}="${v}";`);

　　　　}

　　　}

　　} catch(e) {}

　')"

fi

　# 3. 寻找真实的 Claude 可执行文件路径

REAL_CLAUDE="${HOME}/.local/bin/claude"

if [[ ! -x "$REAL_CLAUDE" ]]; then

　REAL_CLAUDE="$(command -v claude || true)"

fi

　# 4. 透传参数与信号，保持 stdin/stdout/stderr 纯粹直通

exec "$REAL_CLAUDE" "$@"

WRAPPER_EOF

chmod 700 ~/.local/bin/paseo-claude

{

　"$schema": "https://paseo.sh/schemas/paseo.config.v1.json",

　"version": 1,

　"daemon": {

　　"listen": "127.0.0.1:6767",

　　"relay": { "enabled": true }

　},

　"agents": {

　　"providers": {

　　　"claude": {

　　　　"command": [ "/home/YOUR_USER/.local/bin/paseo-claude" ]

　　　}

　　}

　}

}

　# 全局安装 Paseo CLI

npm install -g @getpaseo/cli

　# 检查版本与路径

paseo --version

[Unit]

Description=Paseo AI Agent Daemon

Documentation=https://github.com/getpaseo/paseo

Wants=network-online.target

After=network-online.target

[Service]

Type=simple

User=YOUR_USERNAME

Group=YOUR_PRIMARY_GROUP

WorkingDirectory=/home/YOUR_USERNAME

Environment="HOME=/home/YOUR_USERNAME"

Environment="PASEO_HOME=/home/YOUR_USERNAME/.paseo"

Environment="SHELL=/bin/bash"

Environment="PATH=/home/YOUR_USERNAME/.local/bin:/home/YOUR_USERNAME/.nvm/versions/node/current/bin:/usr/local/bin:/usr/bin:/bin"

ExecStart=/usr/local/bin/paseo daemon start --foreground

Restart=on-failure

RestartSec=5

TimeoutStopSec=30

[Install]

WantedBy=multi-user.target

sudo systemctl daemon-reload

sudo systemctl enable --now paseo.service

　# 检查服务运行状态

systemctl status paseo.service --no-pager

ss -lntp '( sport = :6767 )'

　# 必须只显示 127.0.0.1:6767，绝不能出现 0.0.0.0:6767

paseo provider diagnostic claude

paseo provider diagnostic codex

paseo daemon pair --relay

•

实时流式与 Timeline 回溯：在手机上启动一个只读审查任务，Agent 的思考过程、命令执行与文件 diff 会实时推送到手机屏幕上。

•

远程权限拦截与审批：当 Codex 或 Claude 尝试执行某些敏感系统命令或文件修改时，手机端会弹出权限确认卡片。你可以直接在屏幕上点击 Approve 或 Reject。

•

内置 Terminal 直通：除了结构化的 Agent Chat，Paseo 手机端还提供了基于 WebSocket 的原生 Terminal 通道，随时可以敲命令查看服务器状态。

5秒内

systemd 自动拉起新进程

免扫码

Relay 凭证持久无感恢复

　# 导入一个已有的 Claude Code 会话 ID

paseo import <YOUR_SESSION_ID> --provider claude --label purpose=mobile-takeover

　# 导入一个已有的 Codex Thread ID

paseo import <YOUR_THREAD_ID> --provider codex --label purpose=mobile-takeover

Paseo 官方开源仓库 (getpaseo/paseo)

https://github.com/getpaseo/paseo

Paseo 官方文档与架构指南 (paseo.sh)

https://paseo.sh

Claude Code 官方架构与使用手册 (Anthropic)

https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview

OpenAI Codex CLI 运行规范 (OpenAI)

https://github.com/openai/codex

systemd.service 官方手册 (freedesktop.org)

https://www.freedesktop.org/software/systemd/man/latest/systemd.service.html

《Claude Code 正在离开聊天框》

https://ntlx.github.io/articles/claude-code-headless-automation

《当计划变成代码——Claude Code Dynamic Workflows 读后感》

https://ntlx.github.io/articles/claude-code-dynamic-workflows

《Anthropic 这篇 skills 文章，真正写的是组织接口》

https://ntlx.github.io/articles/claude-code-skills-organizational-interface

《同一天，OpenAI、Runway、Google 都选了 MCP——一个协议的临界点》

https://ntlx.github.io/articles/mcp-tipping-point