ssh-remote-connection

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SSH Remote Connection

SSH远程连接

Universal skill for connecting to remote servers via SSH.
通过SSH连接远程服务器的通用工具。

Usage

使用方法

bash
undefined
bash
undefined

Interactive shell

交互式shell

scripts/connect.sh
scripts/connect.sh

Run command directly

直接运行命令

scripts/connect.sh "docker compose logs backend --tail 50"
undefined
scripts/connect.sh "docker compose logs backend --tail 50"
undefined

Setup

设置步骤

For Claude Code (local)

针对本地Claude Code

  1. Copy config template:
    bash
    cp config/.env.example config/.env
  2. Fill in
    config/.env
    with actual values
  3. Make script executable:
    bash
    chmod +x scripts/connect.sh
  1. 复制配置模板:
    bash
    cp config/.env.example config/.env
  2. config/.env
    中填写实际值
  3. 赋予脚本执行权限:
    bash
    chmod +x scripts/connect.sh

For Cloud Runtime

针对云运行环境

Set environment variables in your cloud configuration:
  • SSH_HOST
    — server hostname or IP
  • SSH_USER
    — SSH username
  • SSH_KEY_PATH
    — path to private key
  • SSH_KEY_PASSWORD
    — key passphrase (optional)
  • SERVER_PROJECT_PATH
    — project directory on server
在你的云配置中设置环境变量:
  • SSH_HOST
    — 服务器主机名或IP
  • SSH_USER
    — SSH用户名
  • SSH_KEY_PATH
    — 私钥路径
  • SSH_KEY_PASSWORD
    — 密钥密码(可选)
  • SERVER_PROJECT_PATH
    — 服务器上的项目目录

Important Notes

重要注意事项

  • Git operations: Do NOT run
    git pull
    on the server. User will handle git sync manually.
  • Code location: Code is in a private repo, changes must be pushed first then pulled by user.
  • Docker: Use
    docker compose
    (not
    docker-compose
    ) on the server.
  • Git操作:不要在服务器上运行
    git pull
    。用户将手动处理Git同步。
  • 代码位置:代码位于私有仓库中,更改必须先推送,然后由用户拉取。
  • Docker:在服务器上使用
    docker compose
    (而非
    docker-compose
    )。

Example Commands

示例命令

bash
undefined
bash
undefined

View logs

查看日志

scripts/connect.sh "docker compose logs backend --tail 100"
scripts/connect.sh "docker compose logs backend --tail 100"

Restart service

重启服务

scripts/connect.sh "docker compose restart backend"
scripts/connect.sh "docker compose restart backend"

Rebuild and restart

重新构建并重启

scripts/connect.sh "docker compose build backend && docker compose up -d backend"
scripts/connect.sh "docker compose build backend && docker compose up -d backend"

Check status

检查状态

scripts/connect.sh "docker compose ps"
undefined
scripts/connect.sh "docker compose ps"
undefined