Home

GCP Free Wiki

gcp_free 是面向 GCP Compute Engine 免费层实例的 Python CLI 工具集，重点解决一条完整运维链路：

1. 选择或切换 gcloud 账号。
2. 选择目标 GCP 项目。
3. 创建免费层实例。
4. 刷 AMD / EPYC CPU 或刷新外网 IP。
5. 配置防火墙。
6. 远程换源、安装 dae、上传 config.dae。
7. 安装流量监控脚本并查看远程状态。

这个 Wiki 以“使用和维护都能快速定位”为目标。详细代码入口仍在仓库内文档：README.md、contexts/context.md。

快速导航

你要做什么	建议阅读
第一次运行工具	快速开始
找 CLI 命令	CLI 命令速查
避免串账号、串项目、ADC 403	账号、项目和 ADC
一键部署、刷 CPU、刷 IP	setup 与刷机
管理入站和 CDN 出站规则	防火墙
SSH / gcloud 远程执行、脚本和 dae	远程执行
查日志、状态、资源覆盖路径	状态、日志和资源
本地测试、CI、发布 EXE	测试与发布
遇到报错	排障手册
维护代码时要遵守的约束	维护手册

常用入口

Windows：

.\start.ps1

Linux / WSL / Git Bash：

bash start.sh

环境体检：

.\start.ps1 doctor --project-id <项目ID>

一键部署：

.\start.ps1 setup --project-id <项目ID> --account <账号邮箱>

核心原则

• 非交互 CLI 优先保护用户本机的 gcloud / ADC 环境。
• 带 --account 的命令失败时，应恢复原账号、原项目和原 ADC 凭据文件。
• 远端 /tmp 临时文件必须覆盖成功和失败路径清理。
• 修改 CLI、账号上下文、远程脚本或 GitHub Actions 时，必须同步测试和文档。