dsh-remote-tunnel : Run dsh web on a remote Linux server, browsed locally through an auto-reconnecting SSH tunnel

[Linjiangxian0203]

Hello everyone, this is dsh-remote-tunnel!

项目地址 / Project URL:
github.com/Linjiangxian0203/dsh-remote-tunnel · npm: dsh-remote-tunnel@0.1.8

项目介绍 / Introduction:

dsh-remote-tunnel 把 dsh web 跑在远程 Linux 服务器上，本地浏览器通过一条 SSH 隧道访问——会话、文件、实验代码都在服务器端，本地只保留一条隧道。

• 远程端口自动分配：服务器上以 flock 原子完成「登记表去重 + 真实 bind 探测」，多人并发分配互不冲突；每次分配写入服务器端登记表（/etc/dsh-ports.tsv，无写权限时自动降级），audit 可随时对照真实占用审查
• systemd 守护，免 root：有密码 sudo 时用系统级单元，否则自动使用用户级单元 + linger；服务器重启自动拉起、崩溃自动重启
• 断线自动重连：隧道进程退出后按退避序列自动拉起，心跳刷新登记表，down 后不会「诈尸」
• 一条命令安装使用：dsh plugin --profile remote add dsh-remote-tunnel → dsh --profile remote up <host> --open

It runs dsh web on a remote Linux server and tunnels it back to your local browser: sessions and files stay on the server, and only the tunnel lives locally.

• Atomic remote port allocation — flock-protected registry de-dup + real bind probe on the server; safe for teams sharing one machine, with an on-server TSV registry that audit compares against real occupancy
• systemd-managed, no root needed — system units with passwordless sudo, user units + linger without
• Auto-reconnecting tunnel with backoff respawn and heartbeats; cross-process cancellation so a tunnel never resurrects after down
• One command to install and use: dsh plugin --profile remote add dsh-remote-tunnel → dsh --profile remote up <host> --open

截图 / Screenshots:

$ dsh plugin --profile remote add dsh-remote-tunnel
$ dsh --profile remote up lab --open
allocated remote port 3082 (range 3080-3119, registered for alice)
linger enabled for alice (service survives logout)
[tunnel lab] connecting — attempt 1
✓ tunnel up — http://127.0.0.1:3081 (remote lab:3082)

  local:    http://127.0.0.1:3081
  auth:     http://127.0.0.1:3081/?token=...   (dsh launch-token auth)
  remote:   127.0.0.1:3082 (unit dsh-web)
  registry: /home/alice/.dsh-ports.tsv — port 3082 in-use by alice

与 DSH 的集成 / How it integrates with DSH:

• 以 dsh.bundle manifest + cordis.patch.yml 发布，任何 profile 经 dsh plugin add 安装
• CLI profile 通过 parseCmdline（@deepseek-ai/dsh-cmdline）解析 launcher 参数快照
• web profile 经 commands.register 注册 /remote 斜杠命令
• 依赖 webStartup 挂载点自动判定 web 表面，仅提供服务、不争抢命令行
• 官方 @deepseek-ai/* 以 peerDependencies 声明，26 项测试覆盖分配/登记/重连/审计

[zmycwdbs]

没看懂，本地dsh ssh连接服务器跟把dsh放服务器中再用ssh连接有什么区别呢