它是什么:广陈皮与溯源场景
一句话说,广陈皮是什么?它是以广东新会陈皮为代表,是经晒制并陈化后的柑橘皮。做 gcpok.com 这类资料站时,不用先买服务器,也不用写后端;先把业务问题拆成数据:产地、批次、年份、图片、检测报告和查询页面。
- 产地、批次、年份:写成字段,如“广东新会”“batch-001”“2021”;年份别写“三年左右”。
- 图片、检测报告:存文件路径,表格只记 images/…、reports/…,别把文件塞进表格。
- 查询页面:一个 query.html,扫码后读同一份数据,给人看而不是给程序猜。
为什么放到 GCP?资料站需要低成本、可访问、可扩展和可备份。Cloud Storage 像一个带网址的网盘:按量付费,几张图片和几份 PDF 很便宜;给公开读权限后,手机和电脑都能打开;访问量变大不用自己加机器;开启版本控制,误删旧文件还能找回。
下面这段可以直接整段复制执行。先装好 Google Cloud CLI;第一行 gcloud init 会引导登录并选项目,按提示走即可。它先造最小样例再上传,是为了让每个字段都有对应文件;以后换图或补报告,只替换对象,不动结构。
gcloud init
PROJECT_ID="$(gcloud config get-value project 2>/dev/null)"
if [ -z "$PROJECT_ID" ] || [ "$PROJECT_ID" = "(unset)" ]; then echo "没有拿到项目 ID,请重新运行 gcloud init"; exit 1; fi
BUCKET="guangchenpi-$PROJECT_ID-$(date +%s)"
REGION="asia-east1"
mkdir -p ./guangchenpi-demo/images ./guangchenpi-demo/reports
cat > ./guangchenpi-demo/data.csv <<'EOF'
sku,origin,batch,year,photo,report,query_page
GCP001,广东新会,batch-001,2021,images/batch-001.jpg.txt,reports/batch-001.pdf.txt,query.html
EOF
printf '示例图片占位n' > ./guangchenpi-demo/images/batch-001.jpg.txt
printf '检测报告占位n' > ./guangchenpi-demo/reports/batch-001.pdf.txt
cat > ./guangchenpi-demo/query.html <<'EOF'
<p>批次 batch-001:产地广东新会,年份 2021。</p>
<p>图片:images/batch-001.jpg.txt;检测报告:reports/batch-001.pdf.txt</p>
EOF
cat > ./guangchenpi-demo/index.html <<'EOF'
<p>广陈皮是什么:以广东新会陈皮为代表,是经晒制并陈化后的柑橘皮。</p>
<p><a href="query.html">查看批次查询页</a>,<a href="data.csv">查看数据</a></p>
EOF
gcloud storage buckets create "gs://$BUCKET" --location="$REGION" --uniform-bucket-level-access
gcloud storage buckets update "gs://$BUCKET" --versioning
gcloud storage cp -r ./guangchenpi-demo/* "gs://$BUCKET/"
gcloud storage buckets add-iam-policy-binding "gs://$BUCKET" --member=allUsers --role=roles/storage.objectViewer
printf '访问地址:https://storage.googleapis.com/%s/index.htmln' "$BUCKET"
打开最后打印的访问地址,就能看到查询页入口。这里没有数据库和后端,适合先把溯源逻辑跑通;等字段稳定了,再接数据库或搜索也不迟。
小白容易踩的坑:Bucket 名全球唯一,命令已用项目 ID 加时间戳,别改成中文、大写或空格;公开读不是公开写,别给 allUsers 写权限;若组织策略禁止公开访问,会报权限错,练习请用个人测试项目。
解决什么问题:从纸质记录到可查可管
做「广陈皮是什么」资料时,常见痛点是散:纸质本写产地,微信群发报告,电脑里放照片。过几个月问“这批哪年收、检测报告在哪”,只能翻记录;换手机或同事离职,图片和报告还可能丢。办法是每批只认一个批次号:图片和报告放 Cloud Storage,批次字段放 Firestore;以后要复杂报表再换 Cloud SQL,字段不用重做。
先在 Cloud Shell 顶部选好项目,整段复制下面命令,不要改名字。它会建资料桶、开版本控制和禁止公开访问,建 Firestore 默认库,建只能新增文件的录入服务账号,并上传示例图片和报告。
(
set -e
gcloud services enable storage.googleapis.com firestore.googleapis.com logging.googleapis.com iam.googleapis.com
export PROJECT_ID="$(gcloud config get-value project 2>/dev/null)"
if [ -z "$PROJECT_ID" ]; then echo "请先在 Cloud Shell 顶部选择项目,再重新复制这一段"; exit 1; fi
export BUCKET_NAME="guangchenpi-$PROJECT_ID-$(date +%s)"
gcloud storage buckets create "gs://$BUCKET_NAME" --location=asia-east1 --uniform-bucket-level-access --public-access-prevention
gcloud storage buckets update "gs://$BUCKET_NAME" --versioning-enabled
gcloud firestore databases list --format='value(name)' | grep -q '/databases/(default)' || gcloud firestore databases create --location=asia-east1 --type=firestore-native
gcloud iam service-accounts describe "gcp-uploader@$PROJECT_ID.iam.gserviceaccount.com" >/dev/null 2>/dev/null || gcloud iam service-accounts create gcp-uploader --display-name="广陈皮录入"
gcloud storage buckets add-iam-policy-binding "gs://$BUCKET_NAME" --member="serviceAccount:gcp-uploader@$PROJECT_ID.iam.gserviceaccount.com" --role="roles/storage.objectCreator"
printf '批次:GCP-2025-001,产地:新会,检测:合格n' > report.txt
base64 -d > photo.png <<'PNG'
iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+/lX8AAAAASUVORK5CYII=
PNG
gcloud storage cp report.txt
怎么上手:GCP 与 Linux 最小可用部署
第一次碰云服务器别慌,按「能跑、不贵、不被扫」来。先做一次准备:官网下个 Cloud SDK,解压跑 ./google-cloud-sdk/install.sh,再 gcloud init 登录;顺手在控制台绑好信用卡、抄下「结算账号 ID」。坑:只建项目不挂结算,开机器必报 billing account not linked。下面前 4 行改成自己的,之后整段复制就行。
# 1. 只改这 4 行,后面原样复制
PROJECT_ID="gcpok-demo-001"
BILLING_ID="000000-111111-222222"
MY_IP="1.2.3.4/32" # 搜「我的 IP」,必须带 /32
ME="you@example.com"
gcloud projects create $PROJECT_ID
gcloud billing projects link $PROJECT_ID --billing-account=$BILLING_ID
gcloud config set project $PROJECT_ID
# 最小权限:全绑在当前项目,不给 Owner
for R in roles/compute.instanceAdmin.v1 roles/iam.serviceAccountUser
roles/storage.admin roles/cloudsql.admin roles/cloudsql.client; do
gcloud projects add-iam-policy-binding $PROJECT_ID
--member="user:$ME" --role="$R" --quiet
done
权限没给 Owner——小白最爱勾 Owner,结果误删了连个拦都没有。建库要 cloudsql.admin、连库才用 client,两个都给但不出这个项目。--quiet 是怕命令卡在「是否继续 y/N」上。
接着开最便宜的 e2-micro,网页放开、SSH 只认你自己:
# 2. 开机器 + 自建防火墙
gcloud services enable compute.googleapis.com
gcloud compute instances create web-01
--zone=asia-east1-b --machine-type=e2-micro
--image-family=debian-12 --image-project=debian-cloud
--tags=http-server,ssh-mine
gcloud compute firewall-rules create allow-web
--allow=tcp:80,tcp:443 --target-tags=http-server --source-ranges=0.0.0.0/0
gcloud compute firewall-rules create allow-ssh-only-me
--allow=tcp:22 --target-tags=ssh-mine --source-ranges=$MY_IP
默认网络自带一条「允许全网 SSH」,去控制台把 default-allow-ssh 禁用,只留上面带 tag 的两条。最大的坑是 MY_IP 图省事写成 0.0.0.0/0,半夜就被扫了;换 Wi-Fi 后 IP 变了,回来改这条规则即可。
不用自己 ssh-keygen,gcloud 帮你管密钥,一条命令远程放好页面,再挂存储和数据库:
# 3. 非交互连上去装 Nginx,不会卡在 SSH 里出不来
gcloud compute ssh web-01 --zone=asia-east1-b
--command='sudo apt update -qq && sudo apt install -y -qq nginx && echo "<h1>我的第一次上线 ✅</h1>" | sudo tee /var/www/html/index.html && sudo systemctl restart nginx'
# 回自己电脑:建图片桶 + 最小数据库
gcloud storage buckets create gs://$PROJECT_ID-assets --location=asia-east1
gcloud sql instances create db-01 --database-version=POSTGRES_15
--tier=db-f1-micro --region=asia-east1
静态页交给 Nginx,图片丢 gs:// 桶用 SDK 读,账号密码走 db-01 内网连,三者分开以后好扩容。坑:别给数据库勾「公共 IP」;db-f1-micro 不像 VM 有免费额度,不用就删。
收尾三件套:域名 A 记录指到查出来的外部 IP;确认防火墙只剩那两条;装好代理后去「Monitoring」看眼 CPU 和 80 端口。
# 4. 查 IP + 装基础监控代理
gcloud compute instances describe web-01 --zone=asia-east1-b
--format='value(networkInterfaces[0].accessConfigs[0].natIP)'
gcloud compute ssh web-01 --zone=asia-east1-b
--command='curl -sSO https://dl.google.com/cloudagents/add-google-cloud-ops-agent-repo.sh && sudo bash add-google-cloud-ops-agent-repo.sh --also-install'
浏览器打开 http://你的域名 看到那行字,第一次上线就成了。记牢三件事:不给 Owner、不开全网 SSH、不用了就 gcloud compute instances delete web-01 --zone=asia-east1-b,不然下个月账单会教你做人。
与替代方案对比:VM、Cloud Run 与传统主机
聊完「广陈皮是什么」,真动手做个查询小页,问题就变成:放哪儿?广陈皮怕潮要挑仓、得定期翻晒;你的小服务也怕丢、怕宕、怕被乱改。别急着买最贵的,按「愿意操多少心」选,下面命令都能直接复制。
- Linux VM:边学边改,控制力最强。像自己有台电脑,改完刷新就见效。建机器后顺手装好服务和防火墙工具、只查状态不启用,就是让你看清:补丁和端口以后都得自己管。
gcloud compute instances create chenpi-vm --zone=asia-east1-b --machine-type=e2-micro --image-family=debian-12 --image-project=debian-cloud gcloud compute ssh chenpi-vm --zone=asia-east1-b --command="sudo apt update && sudo apt install -y nginx ufw && sudo ufw status verbose"坑:没跑
gcloud init、没绑结算账号会报错,刚建好连不上等半分钟再试;开防火墙前务必先sudo ufw allow OpenSSH,直接 enable 会把 SSH 锁在外面;机器不用了要删,开着就一直计费。 - Cloud Run:轻量接口、省运维。不建机器,给个容器就出网址,没流量基本不花钱。故意用官方示例镜像,是不用先写 Dockerfile 也能一次跑通,先感受「无服务器」再补容器概念。
gcloud run deploy chenpi-api --image gcr.io/cloudrun/hello --region asia-east1 --allow-unauthenticated gcloud run services describe chenpi-api --region asia-east1 --format="value(status.url)"坑:首次会自动启用 API,等十几秒,没绑结算账号才真报错;
--allow-unauthenticated是谁都能访问,别放真实台账;首访偏慢是冷启动,不是坏了。小白最卡的一步,是先得接受「容器=打包好的运行环境」「无服务器=不用管机器」。 - 传统主机、网盘或本地表格:初期最省事。双击就改,发给谁都行。但备份靠手敲、扩容靠换电脑、权限靠发文件、监控靠自己记得看。先建空目录再打包,就是让你亲手体会一次手动备份有多容易忘。
mkdir -p ./data && tar -czvf chenpi-backup-$(date +%F).tar.gz ./data ls -lh chenpi-backup-*.tar.gz坑:中文文件名换台电脑容易乱码,同名一覆盖就回不去,几个人各存一份、谁改了根本查不到。等数据多了、要给别人访问,就该往前两种挪了。
怎么挑:想看懂每一步用 VM,只要接口稳稳在线用 Cloud Run,纯自己记着玩先表格——但尽早把备份改成自动的。
最佳实践:安全、备份与成本控制
gcpok.com 做「广陈皮是什么」资料站,先把门关小:只改文章的人给查看/写入权限,只有运维才给 SSH,别发 Owner。已装好 gcloud 并登录后,复制执行下面命令:先看现有高权限,再给当前账号 OS Login,让每个人上传自己的公钥,不共享私钥,这样丢一台电脑也不会全站失守。
PROJECT_ID="$(gcloud config get-value project)"
ACCOUNT="$(gcloud config get-value account)"
case "$ACCOUNT" in *.gserviceaccount.com) MEMBER="serviceAccount:$ACCOUNT";; *) MEMBER="user:$ACCOUNT";; esac
gcloud projects get-iam-policy "$PROJECT_ID" --flatten="bindings[].members" --format="table(bindings.role,bindings.members)"
gcloud projects add-iam-policy-binding "$PROJECT_ID" --member="$MEMBER" --role="roles/compute.osLogin"
gcloud compute project-info add-metadata --project "$PROJECT_ID" --metadata=enable-oslogin=TRUE
坑:清理高权限前确认不是服务账号;开 OS Login 后旧的 authorized_keys 可能失效,先保留一个管理员会话。再禁用密码登录,避免弱口令被扫到:
read -r -p "VM 名称: " VM_NAME
read -r -p "可用区,如 asia-east1-b: " ZONE
gcloud compute ssh "$VM_NAME" --zone "$ZONE" --command
'sudo install -d -m 755 /etc/ssh/sshd_config.d && printf "PasswordAuthentication nonKbdInteractiveAuthentication non" | sudo tee /etc/ssh/sshd_config.d/00-no-password.conf >/dev/null && sudo sshd -t && (sudo systemctl reload ssh || sudo systemctl reload sshd)'
备份要能恢复才算数:资料桶开版本控制并另存一份,Cloud SQL 开每日自动备份,VM 磁盘建每日快照;每月把备份恢复到临时桶、临时库或临时磁盘核对一次,别覆盖生产。下面先手动跑通,再在控制台用 Storage Transfer 建每日 03:20 作业,源桶、目标桶填上面两个名字。
read -r -p "原资料桶名(不含 gs://): " SRC_BUCKET
read -r -p "备份桶名(不含 gs://): " BACKUP_BUCKET
gcloud storage buckets create "gs://$BACKUP_BUCKET" --location=asia-east1 2>/dev/null || true
gcloud storage buckets update "gs://$SRC_BUCKET" --versioning
gcloud storage buckets update "gs://$BACKUP_BUCKET" --versioning
gcloud storage rsync -r "gs://$SRC_BUCKET" "gs://$BACKUP_BUCKET"
read -r -p "Cloud SQL 实例名: " SQL_INSTANCE
gcloud sql instances patch "$SQL_INSTANCE" --backup-start-time="03:00"
REGION="${ZONE%-*}"
gcloud compute resource-policies describe daily-vm-backup --region="$REGION" >/dev/null 2>&1 ||
gcloud compute resource-policies create snapshot-schedule daily-vm-backup --region="$REGION" --max-retention-days=7 --on-source-disk-delete=keep-auto-snapshots --daily-schedule --start-time=04:00
read -r -p "系统盘名(通常与 VM 同名): " DISK_NAME
gcloud compute disks add-resource-policies "$DISK_NAME" --zone="$ZONE" --resource-policies=daily-vm-backup
控费别等账单来了才看:在「结算 > 预算和提醒」设 50%、90%、100% 邮件提醒;在「监控 > 提醒」给 CPU、磁盘、5xx 配告警;日志只留 30 天;非 24 小时站点用「实例计划」设 23:00 停、08:00 起,先用下面命令验证关机。
gcloud logging buckets update _Default --location=global --retention-days=30 --project="$PROJECT_ID"
gcloud compute instances stop "$VM_NAME" --zone="$ZONE"
坑:桶名全球唯一;备份桶若仍在同一项目,误删项目会一起没,重要资料再开跨区域复制;重复绑定快照策略提示已存在可忽略。日志留太久、关机后未释放的磁盘和静态 IP 都会继续收费。最后,页面只做资料展示;涉及功效或医疗建议时,引用《中国药典》、地方标准或论文要写清来源和日期,用“记载”“研究参考”,不写“治愈”“保证有效”,也不给剂量或替代就医建议。
常见问题(FAQ)
广陈皮是什么,和普通陈皮有何区别?
区别主要在产地、品种和陈化标准,广陈皮通常指广东新会一带陈皮。
小白一定要买 VM 才能练吗?
不一定,可先用 Cloud Storage 静态页面练习,设好预算提醒后再加 VM。
GCP 上最该先做哪项运维设置?
先配好预算提醒、IAM 最小权限和备份,再开放公网访问。
资料站需要数据库吗?
批次少可用表格文件,数据多、查询多时再上 Cloud SQL 或 Firestore。
不想自己折腾 GCP?我们提供云平台代维护、上云迁移与账单代付服务,一对一技术支持。
