添加第一台服务器
准备服务器地址、端口、用户名和认证方式。保存后可以从工作区直接连接，不用每次重新输入连接参数。
- 确认服务器允许 SSH 登录。
- 选择密码或密钥认证。
- 保存连接后进入服务器工作区。
Help Center
快速开始
连接后先看状态
进入工作区后，先查看 CPU、内存、磁盘、网络和服务状态。这样可以判断是资源问题、服务问题还是配置问题。
- 查看资源占用是否异常。
- 检查磁盘空间和负载。
- 再进入日志、Docker 或 Nginx 面板。
需要命令时再使用终端
DuskShell 保留完整 SSH 终端。常用命令会提供提示和解释，但执行前仍由你确认。
- 先看命令含义和参数。
- 确认目标路径、容器或服务名。
- 涉及删除、重启、覆盖时先备份。
SSH 连接和命令提示
- 连接失败时，先确认服务器地址、端口、防火墙、安全组和用户名是否正确。
- 密钥登录失败通常和密钥格式、权限、passphrase 或服务器 authorized_keys 配置有关。
- 命令提示适合查常用参数，例如查看日志、检查端口、重启服务、压缩文件和定位配置。
- DuskShell 不会替你静默执行危险命令。修改配置、删除文件、重启服务前仍需要你确认。
文件管理
- 适合上传配置、下载日志、查看站点目录、整理部署脚本和快速定位文件。
- 编辑生产配置前建议先复制一份备份，例如 nginx.conf、.env、docker-compose.yml。
- 如果上传失败，检查目标目录权限、磁盘空间、路径是否存在，以及当前用户是否有写入权限。
- 不要把私钥、令牌、数据库密码或客户敏感数据上传到不必要的位置。
Docker 管理
- 可以查看容器列表、状态、端口、镜像、启动时间和最近日志。
- 容器异常时，先看退出码和日志，再决定是否重启。频繁重启通常说明配置、依赖或资源有问题。
- 执行 restart、stop、remove 前确认容器名和影响范围，避免误停生产服务。
- 排查镜像或部署问题时，优先查看 docker logs、环境变量、挂载目录和网络配置。
Nginx 管理
- 适合查看站点配置、检查语法、定位证书路径、查看访问日志和错误日志。
- 重载前先做配置检查，避免错误配置导致站点不可用。
- 502/504 常见原因包括上游服务未启动、端口不对、容器网络不通或超时配置过短。
- HTTPS 问题通常和证书路径、证书链、域名解析和监听端口有关。
账号、会员和设备
- 账号用于管理会员权益、设备授权和升级入口，不绑定某一台服务器会话。
- 设备达到上限时，可以在账号中心移除旧设备后再激活新设备。
- 会员价格、周期、设备数量和权益从后台接口读取，后台调整后官网会同步展示。
- 如果登录后看不到会员状态，先刷新账号中心，再检查网络或后台服务是否可用。
安全建议
- 优先使用密钥登录，并给密钥设置 passphrase。
- 生产服务器建议使用最小权限账号，不要长期使用 root 直接操作。
- 修改 Nginx、Docker、系统服务或关键配置前，先备份并确认回滚方式。
- AI 解释和命令提示只作为辅助，最终操作仍由你判断。
常见故障排查
SSH 连不上
检查服务器是否在线、端口是否开放、防火墙和安全组是否允许访问、用户名是否正确、认证方式是否匹配。
密钥提示权限或格式错误
确认密钥没有损坏，passphrase 正确，服务器 authorized_keys 已配置，私钥文件权限没有被系统拒绝。
Docker 容器一直重启
先看容器日志和退出码，再检查环境变量、端口占用、依赖服务、挂载目录和镜像版本。
Nginx 502
检查 upstream 服务是否运行、端口是否正确、容器网络是否可达、反向代理路径和超时配置是否合理。
文件上传失败
检查目标目录权限、磁盘空间、路径是否存在，以及当前 SSH 用户是否有写入权限。
会员或设备状态不对
刷新账号中心，确认当前登录账号正确；如果设备达到上限，先撤销旧设备后再重试。
联系支持
如果你需要人工支持，请尽量说明操作系统、DuskShell 版本、服务器类型、报错信息和你已经尝试过的排查步骤。不要发送密码、私钥、令牌或完整生产配置。
support@duskshell.com