GooseHost CLI 是一个在终端里管理 GooseHost 静态网站的命令行工具，不需要开浏览器。

安装

pip install goosehost-cli

安装后，在终端输入 goosehost 就可以用了。

快速开始

1. 登录（只做一次）

goosehost login --email 你的邮箱 --password 你的密码

登录后凭证保存在本地，下次不用再输入。

2. 部署一个 HTML 文件

goosehost deploy ./index.html

./index.html 表示当前目录下的 index.html 文件。
工具会自动用文件名作为网站名称，并在终端显示访问地址。

3. 查看所有网站

goosehost list

完整命令列表

登录与账号

网站管理

快捷部署

其他

文件路径怎么写

在命令中，所有 --file 和 --output 后面的路径都支持两种写法：

• 相对路径：相对于当前终端所在的目录
  例如：./index.html、backup.html、../my-site/index.html

• 绝对路径：从磁盘根目录开始的完整路径
  例如：D:/my-site/index.html、C:\Users\Administrator\backup.html

如果不确定当前终端在哪个目录，可以输入：

• Windows：cd
• Mac/Linux：pwd

常用操作示例

部署当前文件夹里的首页

goosehost deploy ./index.html

输出示例：

部署成功！
  访问地址: https://page.goose.cc.cd/s/my-site
  网站名称: my-site

直接用文字创建一个 Markdown 网站

goosehost create --slug my-doc --type md --content "# 我的文档\n\n这是内容"

把线上网站下载到本地修改

下载到当前目录：

goosehost get --slug my-site --output backup.html

下载后，当前目录会多出一个 backup.html 文件。
如果你想保存到其他文件夹，可以写完整路径：

goosehost get --slug my-site --output D:/my-backup/index.html

修改后用本地文件更新：

goosehost update --slug my-site --file backup.html

如果文件在其他路径，就填完整路径：

goosehost update --slug my-site --file D:/my-backup/index.html

查看网站内容（不保存，只显示）

goosehost get --slug my-site

终端会直接打印出网站的全部代码。

删除一个网站

goosehost delete --slug my-site --force

卸载

pip uninstall goosehost-cli

常见问题

登录后每次都要重新登录吗？

不用。凭证保存在本地，下次打开终端会自动生效。

安装后输入 goosehost 提示找不到命令？

重启终端。如果还不行，检查 Python 的 Scripts 目录是否在系统 PATH 里。

为什么删除网站必须加 --force？

防止手滑误删。确认你真的要删，再加 --force。

更多帮助

查看所有命令：

goosehost --help

查看某个命令的详细用法：

goosehost create --help

Enjoy your static sites!