连接实例

连接方式

SynpixCloud 实例支持多种连接方式：

SSH - 通过终端进行命令行访问
VSCode Remote - 完整的 IDE 体验
Jupyter Notebook - 基于浏览器的 Python 环境

SSH 连接

基本 SSH 连接

从实例控制台获取连接详情
打开终端并运行：

ssh -p <端口> root@<主机>

按提示输入 root 密码

不同系统的 SSH 连接

macOS / Linux

使用内置的终端应用：

ssh -p 12345 root@gpu.synpixcloud.com

Windows

使用 PowerShell、Windows Terminal 或安装 SSH 客户端：

ssh -p 12345 root@gpu.synpixcloud.com

或使用 PuTTY 图形化 SSH 客户端。

SSH 密钥认证

配置免密登录，添加您的公钥：

# 在本地机器上
cat ~/.ssh/id_rsa.pub

# 在远程实例上
mkdir -p ~/.ssh
echo "您的公钥" >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

保持 SSH 会话活跃

防止长时间操作时断开连接，配置 SSH 保活：

# 添加到本地机器的 ~/.ssh/config
Host *
    ServerAliveInterval 60
    ServerAliveCountMax 3

运行后台进程

使用 screen 或 tmux 让进程在断开连接后继续运行：

使用 Screen

# 创建新的 screen 会话
screen -S training

# 运行您的命令
python train.py

# 分离：按 Ctrl+A，然后按 D

# 稍后重新连接
screen -r training

使用 tmux

# 创建新的 tmux 会话
tmux new -s training

# 运行您的命令
python train.py

# 分离：按 Ctrl+B，然后按 D

# 稍后重新连接
tmux attach -t training

VSCode 远程连接

直接从 Visual Studio Code 连接到您的实例，获得完整的 IDE 体验。

设置

安装 VSCode
安装 Remote - SSH 扩展

连接

按 Ctrl+Shift+P（macOS 上按 Cmd+Shift+P）
输入 Remote-SSH: Connect to Host
输入：root@<主机> -p <端口>
按提示输入密码

SSH 配置便捷访问

添加到您的 ~/.ssh/config：

Host synpix-gpu
    HostName gpu.synpixcloud.com
    Port 12345
    User root

现在只需执行以下命令即可连接：

ssh synpix-gpu

或在 VSCode 的 Remote-SSH 主机列表中选择 "synpix-gpu"。

VSCode 连接故障排除

如果 VSCode 无法连接：

检查 SSH 访问 - 先验证能否通过终端连接
更新 Remote-SSH - 确保扩展是最新版本
检查服务器要求 - 实例需要足够的内存运行 VSCode Server
清除服务器缓存 - 运行 "Remote-SSH: Kill VS Code Server on Host"

Jupyter Notebook

通过浏览器访问 Jupyter Notebook 进行交互式 Python 开发。

访问 Jupyter

如果您的实例已预装 Jupyter：

在连接详情中找到 Jupyter URL
在浏览器中打开该 URL
如有提示，输入令牌/密码

手动安装 Jupyter

如果未预装 Jupyter：

# 安装 Jupyter
pip install jupyterlab

# 启动支持远程访问的 Jupyter
jupyter lab --ip=0.0.0.0 --port=8888 --no-browser --allow-root

确保在实例设置中将端口 8888 映射到外部端口。

Jupyter 安全设置

在远程服务器上运行 Jupyter 时：

# 设置密码
jupyter lab password

# 生成配置
jupyter lab --generate-config

# 编辑配置以要求密码
# 在 jupyter_lab_config.py 中设置 c.ServerApp.password

端口映射

将内部端口映射到外部访问，用于 Web 服务、API 或自定义应用程序。

常用端口映射

服务	内部端口	用途
Jupyter	8888	Notebooks
TensorBoard	6006	训练可视化
Gradio	7860	ML 演示
API 服务器	8000	REST APIs

配置端口映射

进入实例设置
导航到 端口映射
添加您的内部端口
记下分配的外部端口

通过以下地址访问您的服务：http://<主机>:<外部端口>

连接故障排除

无法通过 SSH 连接

检查实例状态 - 确保是"运行中"
验证凭据 - 仔细检查主机、端口和密码
检查网络 - 确保您的网络允许出站 SSH
等待启动 - 新实例可能需要 1-2 分钟

连接频繁断开

配置 SSH 保活（见上文）
对重要进程使用 screen 或 tmux
检查本地网络稳定性

连接缓慢

检查本地网络带宽
如果距离服务器区域较远，考虑使用 VPN
大文件传输时，使用带压缩的 rsync：

rsync -avz --progress local_file root@host:remote_path -e "ssh -p <端口>"

支持

遇到连接问题？请联系我们：support@synpixcloud.com

连接实例

On this page