1. 从一次部署失败说起免费体验版为什么突然不能用了2025年初我照例打开腾讯云 CloudBase 控制台准备把一个刚写完的纯前端项目挂到静态站点托管上。项目本身很简单Vite 打包出来的 dist 目录几个 HTML、CSS、JS 文件没有任何后端逻辑。按照过去的习惯我点进「静态网站托管」新建环境上传文件绑定默认域名十分钟搞定。结果这次点进去页面提示我当前套餐不支持静态网站托管功能。我一开始以为是浏览器缓存或者控制台改版导致的显示问题换了浏览器、清了缓存、重新登录提示依旧。后来去翻腾讯云的公告和计费文档才确认2025年腾讯云对 CloudBase 的套餐体系做了调整免费体验版不再包含静态网站托管能力这个功能被划到了付费套餐里。这个变化对很多习惯「白嫖」CloudBase 静态托管的个人开发者来说影响挺直接的。过去大家拿它当免费的静态页面 CDN 用部署个人博客、文档站、活动页、简历页成本几乎为零。政策一调整原来的路径走不通了就得重新想方案。这篇文章记录的就是我在这个政策变化之后重新探索 CloudBase 静态站点托管完整部署的整个过程。我会把踩过的坑、验证过的路径、以及不同预算下的选择逻辑都摊开讲。适合两类人看一类是手里有 CloudBase 环境、想搞清楚现在到底还能怎么部署静态站点的开发者另一类是正在选型、纠结要不要上 CloudBase 的个人或小团队。文章里涉及的操作步骤和参数配置都是我在实际环境里跑通过的不是纸上谈兵。需要先说明一点腾讯云的套餐政策和计费规则是会持续调整的我写的是2025年这个时间点的实际情况。你在操作时一定要以控制台里当下显示的套餐说明和计费文档为准不要拿几个月前的教程直接套。2. 先搞清楚 CloudBase 静态托管到底是个什么东西2.1 它解决的其实是「前端文件往哪放」的问题很多人第一次接触 CloudBase是被「云开发」这个概念吸引的以为它是个全能后端。但静态网站托管这个模块本质上做的事情非常朴素把你打包好的静态文件分发到腾讯云的 CDN 节点上并给你一个可访问的域名。你可以把它理解成一个「带 CDN 的文件柜」。你把 dist 目录里的东西塞进去它负责存储、加速、对外提供 HTTPS 访问。它不执行你的 Node.js 代码不跑数据库查询也不处理服务端渲染。所有逻辑都必须在你上传之前就已经编译成静态资源。这一点特别重要因为很多人会把「静态托管」和「云函数」「云数据库」混在一起理解。它们是 CloudBase 里并列的能力静态托管只负责文件分发这一件事。你如果有一个需要服务端接口的项目静态托管只能承载前端部分接口还得靠云函数或者你自己的服务器。2.2 和对象存储 CDN 的关系从技术实现上看CloudBase 静态网站托管底层依赖的是对象存储COS和内容分发网络CDN。你上传的文件实际存放在 COS 的存储桶里CDN 负责把文件缓存到离用户最近的节点。CloudBase 做的是把这套组合封装成了一个开箱即用的产品省去了你自己配置存储桶权限、CDN 加速域名、HTTPS 证书这些步骤。理解这层关系有个实际好处当静态托管因为套餐限制用不了的时候你完全可以退回到「COS CDN」这条更底层的路径自己手动搭一套。功能上能做到几乎等价只是配置步骤多一些。后面我会专门讲这条替代路线。2.3 默认域名和自定义域名的区别CloudBase 静态托管会给你一个默认域名格式大概是xxx-环境ID.tcloudbaseapp.com这种。这个域名开箱即用自带 HTTPS适合测试和临时访问。但它有两个明显限制一是域名不好看二是默认域名通常有访问频率或流量的隐性约束不适合正式对外。自定义域名就是把你自己的域名比如blog.yourdomain.com绑定上去。绑定过程需要在域名解析里加一条 CNAME 记录指向 CloudBase 提供的目标地址然后在控制台里上传 SSL 证书或者用腾讯云托管的证书。这一步是正式上线的必经环节也是新手最容易卡住的地方——CNAME 配错、证书没生效、解析没传播都会导致域名访问不了。3. 2025年政策调整后免费体验版到底缺了什么3.1 套餐能力对比我实际验证的结果为了搞清楚免费版和付费版的边界我专门建了两个环境做对照测试。下面这张表是我在2025年实际操作中整理出来的重点看静态托管相关的部分能力项免费体验版付费套餐按量/包月静态网站托管不支持支持云函数调用有限额度按套餐额度云数据库有限额度按套餐额度默认域名访问不适用支持自定义域名绑定不适用支持CDN 加速不适用支持需要强调的是免费体验版并不是「什么都不能做」云函数、数据库这些基础能力在额度内还是能用的。被砍掉的核心就是静态网站托管这一块。所以如果你的项目是纯静态的免费版基本就废了如果你的项目主要靠云函数静态部分只是附带那影响相对小一些。3.2 为什么腾讯云要这么调整站在产品角度想这个调整其实不难理解。静态托管 CDN 是实打实的带宽和存储成本免费用户量一大这部分开销很可观。早期用免费策略拉新等用户规模起来了把高成本能力收进付费套餐是很常见的商业动作。对开发者的启示是不要把长期项目建立在「某个厂商的免费额度」上。免费额度随时可能变一旦变了迁移成本就得你自己扛。我现在的习惯是个人项目尽量选那些「即使收费也很便宜、且迁移路径清晰」的方案而不是赌某个免费政策能一直持续。3.3 政策调整后还有哪些路可以走确认免费版用不了静态托管之后我把可能的路径列了一遍逐个验证升级到付费套餐最直接按量付费的话个人小站一个月可能就几块钱。适合不想折腾、项目要长期跑的人。退回 COS CDN 自建用对象存储放文件自己配 CDN 和域名。灵活度高成本可控但配置步骤多。换用其他静态托管平台市面上有不少专门做静态托管的服务各有免费额度。适合纯静态、不想碰云资源的人。自建服务器 Nginx完全自主但要自己维护服务器、证书、CDN运维成本最高。下面几节我会重点讲前两条因为它们是和 CloudBase 生态最贴近的路径。4. 路径一升级付费套餐后的完整部署流程4.1 开通套餐前先算一笔账在决定付费之前我建议你先估算一下自己的实际用量。静态站点的成本主要来自两块存储和CDN 流量。存储方面一个普通的前端项目打包后也就几 MB 到几十 MB这部分成本几乎可以忽略。真正花钱的是 CDN 流量也就是用户访问你页面时产生的下行流量。假设你的站点首页加资源一共 2MB每天有 500 个访问一个月就是 2MB × 500 × 30 ≈ 30GB 流量。按量付费的单价通常在每 GB 几毛钱这个量级算下来一个月十几块钱。这个估算方法不精确但能帮你判断「付费到底值不值」。如果你的站点访问量很小付费成本可能比你想的低很多如果访问量很大那就要认真考虑 CDN 流量费用了。4.2 环境创建与静态托管开通升级套餐之后操作路径就顺畅了。我按顺序走一遍登录腾讯云 CloudBase 控制台选择或新建一个环境。环境是 CloudBase 里所有资源的容器静态托管、云函数都挂在环境下面。进入环境后在左侧菜单找到「静态网站托管」。这时候应该能看到开通入口而不是之前的套餐限制提示。点击开通系统会引导你完成初始化。这一步会在后台帮你创建对应的存储桶和 CDN 配置通常几十秒完成。注意环境的地域选择会影响访问速度。如果你的用户主要在国内选国内地域如果面向海外选对应的海外地域。地域一旦选定后续迁移比较麻烦创建时要确认好。4.3 用 CLI 上传比控制台拖拽靠谱得多控制台支持手动上传文件但我不推荐。原因很简单手动上传没法版本管理每次更新都要重新拖一遍容易漏文件。正确做法是用 CloudBase CLI。安装 CLI 的命令是npm install -g cloudbase/cli安装完成后登录tcb login登录会弹出授权页面确认后 CLI 就拿到了操作你账号的凭证。接下来在项目根目录执行部署命令tcb hosting deploy ./dist -e your-env-id这里的./dist是你打包后的目录your-env-id是你的环境 ID。这条命令会把 dist 目录下的所有文件上传到静态托管。我实测下来CLI 上传有几个好处一是可以写进 CI/CD 流程push 代码自动部署二是支持增量上传第二次部署只传变化的文件速度快很多三是命令可复用不会出现「上次怎么传的忘了」这种情况。4.4 打包配置里几个容易忽略的点部署能不能成功很大程度上取决于打包产物对不对。我踩过的坑集中在几个地方base 路径问题。如果你的站点部署在子路径下比如yourdomain.com/blog/打包时要把 base 配成/blog/否则页面里的资源引用会 404。Vite 里是base: /blog/Webpack 里是publicPath。路由模式问题。用 Vue Router 或 React Router 的 history 模式时刷新子路由页面会 404因为服务器找不到对应的物理文件。解决办法是在静态托管里配置「索引文档」和「错误文档」都指向index.html让前端路由接管。CloudBase 静态托管支持配置这个在控制台的「基础配置」里设置。缓存策略问题。带 hash 的静态资源比如app.abc123.js可以设长缓存index.html必须设短缓存或不缓存否则用户会一直拿到旧版本。这个在 CDN 缓存配置里调整。5. 路径二绕开静态托管用 COS CDN 自己搭5.1 为什么这条路径值得掌握套餐政策会变但对象存储和 CDN 这两个基础能力几乎所有云厂商都有而且计费透明、迁移路径清晰。学会自己搭一套等于掌握了「不依赖特定产品封装」的通用技能。以后换厂商思路是一样的只是控制台位置不同。5.2 创建存储桶并开启静态网站功能第一步是创建 COS 存储桶。在腾讯云对象存储控制台新建一个桶地域选离用户近的访问权限先设为「私有读写」后面通过 CDN 回源不需要桶本身公开。创建完成后进入桶的「基础配置」找到「静态网站」设置把它开启。这里要填两个东西索引文档填index.html错误文档也填index.html配合前端路由。开启后COS 会给你一个静态网站访问端点格式类似xxx.cos-website.ap-guangzhou.myqcloud.com。5.3 上传文件与目录结构上传文件可以用 COS 控制台也可以用命令行工具 coscmd。文件多的话建议用工具pip install coscmd coscmd config -a SecretId -s SecretKey -b BucketName -r Region coscmd upload -r ./dist/ /这条命令会把 dist 目录下的内容递归上传到桶的根目录。上传完成后你可以先用 COS 提供的静态网站端点访问一下确认文件都在、页面能打开。5.4 配置 CDN 加速与自定义域名COS 自带的访问端点速度一般正式对外要用 CDN。在 CDN 控制台添加加速域名源站类型选「对象存储」指向你刚建的桶。然后配置 CNAME把加速域名解析到 CDN 给的地址。自定义域名这块需要在 CDN 域名配置里绑定你的域名并上传 SSL 证书开启 HTTPS。证书可以用腾讯云免费的 DV 证书申请后自动部署到 CDN。提示CDN 缓存配置里建议对index.html设置不缓存或很短缓存对js/css/图片这类带 hash 的资源设置较长缓存。这样既能保证页面更新及时又能让静态资源充分利用缓存。5.5 和 CloudBase 静态托管的成本对比自己搭 COS CDN成本结构和 CloudBase 静态托管类似都是存储费 流量费。区别在于CloudBase 把配置封装好了省心但灵活性低COS CDN 配置步骤多但每一层你都能控制比如缓存规则、回源策略、防盗链。对于个人小站两者成本差异不大。对于有一定规模的项目自己搭往往更可控因为你能针对性地优化缓存命中率、压缩传输体积把流量成本压下来。6. 部署过程中真正卡住我的几个问题6.1 域名解析生效慢别急着怀疑配置绑定自定义域名后我遇到过「控制台显示已绑定但浏览器访问还是旧页面或者打不开」的情况。第一反应是配置错了反复检查 CNAME其实没问题。真正的原因是DNS 解析传播需要时间尤其是刚修改的解析记录不同地区生效速度不一样快则几分钟慢则几小时。排查方法是用dig或nslookup命令查一下域名当前解析到哪dig blog.yourdomain.com CNAME如果返回的还是旧记录或者没有记录那就是还没传播等着就行。如果返回的已经是 CDN 地址但访问还是不对那才需要查 CDN 配置。6.2 HTTPS 证书不生效的常见原因证书上传了但浏览器还是提示不安全通常是这几个原因一是证书和域名不匹配比如给a.com申请的证书绑到了b.com二是证书链不完整只传了域名证书没传中间证书三是 CDN 那边证书配置没保存或者没同步。我的经验是优先用云厂商托管的证书申请后一键部署省去手动上传的麻烦。如果必须手动传一定要确认证书链完整。6.3 前端路由刷新 404 的根因这个问题前面提过但值得展开说。history 模式下用户访问yourdomain.com/about浏览器会真的向服务器请求/about这个路径。静态托管或 COS 上根本没有about这个文件自然 404。解决办法是配置「错误文档」指向index.html。这样服务器找不到文件时返回index.html前端路由再根据 URL 渲染对应页面。CloudBase 静态托管和 COS 静态网站都支持这个配置一定要设。6.4 大文件上传中断怎么办上传几百 MB 的资源时偶尔会遇到中断。CLI 工具一般支持断点续传重新执行上传命令会跳过已传完的文件。如果用的是控制台手动上传大文件建议改用命令行工具稳定性好很多。另外单个文件如果特别大比如超过 CDN 单文件限制要考虑拆分或者用其他分发方式。静态站点一般不会有超大文件但如果你打包了视频、数据集之类的要提前确认限制。7. 部署完成后的验证清单与日常维护7.1 上线前必须逐项确认的东西每次部署完我都会按这个清单过一遍避免上线后才发现问题首页能否正常打开样式和脚本有没有加载失败看浏览器控制台 Network 面板子路由直接访问和刷新是否正常验证错误文档配置HTTPS 是否生效证书是否有效看地址栏锁标移动端访问是否正常响应式布局、触摸操作关键资源是否命中 CDN 缓存看响应头的X-Cache之类字段页面加载速度是否可接受用浏览器 Performance 面板或在线测速工具7.2 版本回滚怎么做静态站点的一个好处是回滚简单。用 CLI 部署时如果保留了历史版本的打包产物重新部署旧版本即可。更规范的做法是给每次部署打 tag出问题时 checkout 到对应 tag 重新构建部署。如果用的是 COS可以开启版本控制桶里会保留文件的历史版本需要时恢复。这个功能有额外存储成本按需开启。7.3 监控和告警别省站点上线后至少要配一个可用性监控。腾讯云有云监控服务可以配置对域名的拨测一旦访问异常就发告警。CDN 那边也有流量和命中率的监控面板定期看一眼能提前发现异常流量或者缓存配置问题。我个人的习惯是个人小站配个基础的拨测告警就够了不用搞太复杂。关键是「出问题能第一时间知道」而不是等用户来反馈。8. 关于选型我现在的真实想法折腾完这一圈我对「静态站点往哪放」这件事的看法比之前清晰了。如果你的项目就是纯静态访问量不大又不想碰任何云资源那直接用专门的静态托管平台最省事注册即用不用管存储桶、CDN 这些概念。代价是自定义能力弱出问题只能等平台修。如果你已经在用腾讯云生态或者项目后续要接云函数、数据库那 CloudBase 静态托管付费版是最顺的选择配置统一权限打通。政策调整后免费版用不了但按量付费的成本对个人项目来说并不高我实测一个月几块钱到十几块钱的量级。如果你追求完全可控或者项目规模上来了要精细优化成本那 COS CDN 自建是更长远的路。前期配置麻烦一点但每一层都透明迁移和优化都自由。最后分享一个我踩坑后养成的习惯任何依赖免费额度的方案我都会提前想好「如果明天收费了我迁到哪」。想清楚这个问题政策再变也不会慌。静态站点这东西文件本身是标准的 HTML/CSS/JS换哪个平台都能跑真正要迁移的只是配置和域名解析。把打包产物管好把域名握在自己手里剩下的都是可以替换的。