返回首页

我的网站第一次上线:从 GitHub 到 Vercel,卡住我的是两个授权

一个不会写代码的人,第一次把网站放上网的完整过程。真正花时间的不是技术,而是两个授权设置。

今天,我的网站上线了。就是你现在看到的这个网站,当时的网址是 jianzhan-notes.vercel.app。

(后来我买了自己的域名,网站也搬到了 Cloudflare,过程写在这一篇里。)

我不会写代码,网站的代码是 AI 帮我写的。我做的事情是:注册账号、点按钮、做决定。原以为上线会很复杂,实际走下来,真正卡住我的不是技术,而是两个授权设置。

整个流程只有三步

步骤 做什么 用的工具
1 把网站代码存到网上 GitHub
2 让网站工具读取这些代码 授权设置
3 把代码变成别人能打开的网站 Vercel

GitHub 是存放代码的地方。一个项目的代码放在一个“仓库”里,我给这个网站建的仓库叫 jianzhan-notes。

Vercel 是部署平台。它会读取 GitHub 里的代码,生成网页,放到网上。免费版会送一个 .vercel.app 结尾的网址,不用先买域名。

第一个坑:授权了,不等于安装了

我想让 AI 直接把代码传到我的 GitHub 仓库里,于是在 Claude 的设置里关联了 GitHub。关联完以后,它还是看不到我的仓库。

后来在 GitHub 的设置页面找到原因:页面上写着 Claude 已经被“授权”(Authorized),但还没有被“安装”(Installed)到我的账号上。只授权的话,它只能看到公开的仓库,我的仓库是私有的,所以看不到。

解决办法是再做一步“安装”,并且在安装时选上这个仓库。

GitHub 上的第三方工具,“授权”和“安装”是两回事。只授权,工具只能看到你的公开仓库;要访问私有仓库,还得把它安装到你的账号上,并选好允许访问哪些仓库。

第二个坑:Vercel 里找不到新仓库

代码传上去以后,我到 Vercel 新建项目,结果列表里只有我以前的一个仓库,新建的 jianzhan-notes 不在里面。

原因和第一个坑类似:以前安装 Vercel 时,我选的是“只允许访问部分仓库”。新建的仓库不在允许范围内,Vercel 自然看不到。

点列表下方的 Adjust GitHub App Permissions,把新仓库加进去,保存后回来刷新,它就出现了。

每新建一个仓库,都要记得去给需要用它的工具(比如 Vercel)加上访问权限。“只允许访问部分仓库”是个好习惯,更安全,但很容易忘记这一步。

点下 Deploy,13 秒上线

解决授权以后,剩下的步骤几乎不用想:选中仓库,点 Import,Vercel 自动认出网站用的工具(Astro),其他设置都不用改,点 Deploy。

13 秒后,页面显示 “Deployed to Production”,网站就上线了。

还有一个让我意外的地方:之后每次往 GitHub 推送新的代码,Vercel 都会自动重新部署。上线以后,我改了网站的一处设置,只是推送了一下代码,过一分钟刷新网站,改动就已经生效了,我什么都不用点。

给和我一样刚起步的人

  • 先用免费网址上线,不急着买域名。 先把流程走通,确定要长期做了再买。
  • 卡住的时候,先怀疑权限。 工具说“找不到”,很多时候不是东西不存在,而是它没被允许看。
  • 截图问人。 今天两次卡住,我都是把设置页面截图发出去,一眼就能看出问题在哪。