字节游戏运维命令行工具,方便项目研发、QA 同学做自动打包发布与 CI 集成。支持 CDN 上传发布、服务端代码包上传、Docker 镜像管理。
| 命令 | 说明 |
|---|---|
config init | 初始化配置(首次使用,需要 appid 和 authkey) |
gdl upload | 上传游戏客户端 CDN 资源(patch / 安装包 / 其他文件) |
gdl presign-upload | 直传云厂商,不经过 GOPS 中转(仅支持 AWS S3) |
gdl configcreate | 创建 CDN 静态配置文件(patchlist / version 等) |
gdl configupdate | 使用本地文件更新线上静态配置 |
code upload | 上传服务端代码包 |
code download | 下载代码包(仅游戏机房内可用,支持 P2P) |
ctx | 切换当前游戏项目 |
ssh | SSH 登录项目主机 |
update --yes | 更新 CLI 到最新兼容版本 |
check config | 检查当前配置是否生效 |
首次安装或更新 CLI,按以下步骤完成。
macOS:使用 Spotlight(⌘ Space)搜索「终端」或「Terminal」打开。
Windows:打开 PowerShell 或 Git Bash。

复制以下命令粘贴到终端运行,将自动下载并配置 CLI:
macOS 按 ⌘V,Windows 按 Ctrl+V 粘贴后回车执行。
安装完成后,使用以下命令初始化配置(appid 和 authkey 由游戏运维团队提供):
运行 ttgops-cli -V 查看版本号,确认安装成功。