这次讲一下如何用 Vercel 部署 Typecho 动态博客
本文写于 2023 年 1 月 6 日,文中我的问题你可能不会出现,出现其他问题请自行百度
由于我这里有一个玄学问题:Vercel 不能拉取 GitHub 的信息,所以部署部分都使用 Vercel CLI 进行
自己就是按照这个来的,实测没问题(再次:我没问题不代表其他人没问题)
2023 年 1 月 10 日更新:
我这里出现了一个情况:Vercel 拉取 GitHub 信息竟然成功了!我后期会再写一篇关于 GitHub 的教程~
0. 准备工作
首先你需要搞到一个域名(这里我用 Freenom 的一个 ml 域名),电脑上装好 vscode、node.js 和 npm(把以上的一切都配置好,不能出差错),确认Vercel 官网能正常访问(重要!)
1. 新建数据库
进入Railway
![](https://i-blog.csdnimg.cn/blog_migrate/8a0cc23086f39e178ae0dc4fba0d649a.png)
点击Start a New Project
![](https://i-blog.csdnimg.cn/blog_migrate/ef82e9e84f048fe7ff1aac9d6bdfbad2.png)
点击Provision MySQL
![](https://i-blog.csdnimg.cn/blog_migrate/4f0371e4dbb7ae6c83d1536299fef5f9.png)
点击Claim Project,把这个项目变成自己的
在弹出窗口登录(没有账户的可以用 GitHub,也可以直接新注册一个账号)
(默认会新建一个不同名的项目,如果之前有项目但是消失的话不要像我一样慌张 比如我的就是 numerous-birds)
![](https://i-blog.csdnimg.cn/blog_migrate/7a5ea974f97aac034fb8d13593e74a4b.png)
单击那个MySQL,然后进到Variables里面,这就是你的数据库信息。网页保留备用。
**
2. 配置Typecho
**
![](https://i-blog.csdnimg.cn/blog_migrate/75ef3955a6fadf33b33b28bda215c5c8.png)
点击立即下载
![](https://i-blog.csdnimg.cn/blog_migrate/42e4d1f429849f3d316a9f33383b381a.png)
这里推荐下载正式版,你要是想用开发版也不是不行,但是有风险。
(官方下载默认调用 GitHub 的仓库,速度可能不行,请自行解决)
![](https://i-blog.csdnimg.cn/blog_migrate/55fdc22925d3451c81817d4bcc3a155a.png)
下载下来之后是一个压缩包,把它解压到本地目录里。我们发现它的根目录是这样的 ⇑ 。
这时我们需要编辑和添加几个文件。
第一个:编辑 install.php
定位到第773行至775行,把这3行注释掉(前面加个#)
# if (!$writeable) {//第773行# $errors[] = _t('上传目录无法写入, 请手动将安装目录下的 %s 目录的权限设置为可写然后继续升级', $uploadDir);# }//第775行123
这里注释掉是因为在安装的时候安装程序无法访问目录,我们只要跳过这一段的检测就可以了,安装成功后没有大问题(有一个小问题,就是写东西的时候好像不能上传附件)
第二个:添加 vercel.json
{"functions":{"api/index.php":{"runtime":"vercel-php@0.5.2"}},"routes":[{"src":"/(.*)","dest":"/api/index.php"}]}12345678
这里有一个点,runtime 这里有一个 vercel-php@0.5.2 ,0.5.2 是本文撰写时的最新版本,有的教程上写的是旧版本,使用旧版本会因为与 Vercel 网站上设置的 Node.js 版本不兼容。这里填写的版本号要以实际情况为准,要不然部署的时候就会报错。
第三个:创建 api 目录并在目录下添加 index.php
<?php$file=__DIR__.'/..'.$_SERVER["PHP_SELF"];if(file_exists($file)){returnfalse;}else{require_once__DIR__.'/../index.php';}#echo $_SERVER["PHP_SELF"];123456789101112
这里应该没有什么要注意的地方了,就是要新建一个 api 文件夹。
第四个:添加 config.inc.php
<?php/**
* Typecho Blog Platform
*
* @copyright Copyright (c) 2008 Typecho team (http://www.typecho.org)
* @license GNU General Public License 2.0
* @version $Id$
*//** 开启https */define('__TYPECHO_SECURE__',true);/** 定义根目录 */define('__TYPECHO_ROOT_DIR__',dirname(__FILE__));/** 定义插件目录(相对路径) */define('__TYPECHO_PLUGIN_DIR__','/usr/plugins');/** 定义模板目录(相对路径) */define('__TYPECHO_THEME_DIR__','/usr/themes');/** 后台路径(相对路径) */define('__TYPECHO_ADMIN_DIR__','/admin/');/** 设置包含路径 */
@set_include_path(get_include_path().PATH_SEPARATOR.__TYPECHO_ROOT_DIR__.'/var'.PATH_SEPARATOR.__TYPECHO_ROOT_DIR__.__TYPECHO_PLUGIN_DIR__);/** 载入API支持 */require_once'Typecho/Common.php';/** 程序初始化 */Typecho_Common::init();/** 定义数据库参数 */$db=newTypecho_Db('Pdo_Mysql','typecho_');$db->addServer(array('host'=>'数据库地址','user'=>'数据库用户名','password'=>'数据库密码','charset'=>'utf8mb4','port'=>'数据库端口号','database'=>'数据库名称','engine'=>'MyISAM',),Typecho_Db::READ|Typecho_Db::WRITE);Typecho_Db::set($db);1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
这个文件最后 定义数据库参数 这里要填入第一步 Railway 的数据库信息。
3. 配置 Vercel 并部署
注册 Vercel(有 Vercel 账号的可以跳过这步)
首先搞一个账号(可以直接用 GitHub 登录)
登录进去后就可以了
通过 npm 安装 Vercel CLI
终端运行(Linux 的要加 sudo)
npm-ginstall vercel
1
注意这里一定要加 -g,因为只有安装到 global 目录才能直接从终端运行(我用 Windows,只有 global 目录被添加到了 path 中)
部署网站
登录
进入你要部署的目录
终端输入
vc login
1
登录,就用你刚才在官网上的方式登录
直接打开显示的链接,登录后如果出现 CLI Login Success! 的字样就表示成功了。
![](https://i-blog.csdnimg.cn/blog_migrate/5d120014798f8b78ed5407a6e7807da6.png)
部署
接着刚才的,终端输入
vc
1
一路回车应该就可以,下面放上我部署完的结果
Vercel CLI 28.10.1
? Set up and deploy “部署路径”? [Y/n] y (直接回车)
? Which scope do you want to deploy to? 用户名(直接回车)
? Link to existing project? [y/N] n(直接回车)
? What’s your project’s name? 项目名称(直接回车)
? In which directory is your code located? ./(直接回车)
Local settings detected in vercel.json:
No framework detected. Default Project Settings:
- Build Command: `npm run vercel-build` or `npm run build`
- Development Command: None
- Install Command: `yarninstall`, `pnpminstall`, or `npminstall`
- Output Directory: `public`if it exists, or `.`
? Want to modify these settings? [y/N] n (直接回车)
🔗 Linked to 用户名/项目名称 (created .vercel and added it to .gitignore)
🔍 Inspect: https://vercel.com/用户名/项目名称/部署事件唯一码 [3s]
✅ Production: Vercel 自动分配的以 vercel.app 结尾的网址 [24s]
📝 Deployed to production. Run `vercel --prod` to overwrite later (https://vercel.link/2F).
💡 To change the domain or build command, go to https://vercel.com/用户名/项目名称/settings
123456789101112131415161718
如果出现 Production 就可以,有显示 Preview 时候需要运行
vc --prod1
然后是重要的一步。
绑定域名
由于 *.vercel.app 在中国无法访问,所以我们需要绑定一个域名。
这里我用我的域名 xuanxuan1231.ml 做示范,我的域名是在 Freenom 上搞到的,所以我们要做 DNS 的操作也要在 Freenom 上搞。
由于我之前测试 Freenom 设置 DNS 记录很容易出现玄学问题(一个未知问题),所以我就直接把 DNS 托管给了 Gcore。
![](https://i-blog.csdnimg.cn/blog_migrate/2edd259db326601e17847f9ef5de28a7.png)
DNS 配置完成是这样的。A 记录和 CNAME 记录不要按着官方的填,按我这个填,这个是对于中国优化后的 IP 和 CNAME – 参考:Vercel国内无法访问解决方案 - 闻心阁
![](https://i-blog.csdnimg.cn/blog_migrate/30c8e5f6957b0b52ba4d601f4309d29a.png)
进入 Vercel 官网,找到自己的项目,点Settings,然后Domains,根据图中操作。
![](https://i-blog.csdnimg.cn/blog_migrate/11da9bc4626dcf3530ddb7f53df2b4e9.png)
微信翻译的,有些域名中的 xuanxuan 被翻译成了宣宣,并且有的翻译得不对,谅解
![](https://i-blog.csdnimg.cn/blog_migrate/24a372c37d5c40897a2e9134e7b246a3.png)
如果出现像我那样的勾,那么说明 OK 了。
如果出现 Invalid Configuration,那么说明你配置的 DNS 不对。
可以测试一下。
![](https://i-blog.csdnimg.cn/blog_migrate/60dc57cb5852cc688acc1c71aeb3977c.png)
如果出现类似这样的界面,那么说明成功了。
4. 安装 Typecho
在地址栏后面加上 /install.php,比如我的域名是 xuanxuan1231.ml,那么我就应该填 xuanxuan1231.ml/install.php
知道这些可不要瞎动我的东西 – 当然,我安装完肯定要重命名我的安装程序 php 文件哒~大家也是不要把管理的东西直接暴露在网络上
回归正题,如果出现下图,表示你已经成功进入 Typecho 安装程序。
![](https://i-blog.csdnimg.cn/blog_migrate/ae5bb882099ce800a4840def2cf53b25.png)
点击我准备好了,开始下一步
如果成功的话,那么应该显示下图
如果显示上传目录无法写入的话,重新检查你有没有把 install.php 的 773 至 775 行注释掉
注释完之后保存,终端打开部署的目录,输入以下命令并等待至显示 ✅ Production 再次尝试即可。
vc --prod1
![](https://i-blog.csdnimg.cn/blog_migrate/936b504732d4434e43ecf46a560e498d.png)
初始化配置不用动,高级设置也不用动,直接确认,开始安装就行。
如果出现下图,表示你已进入第三步。
![](https://i-blog.csdnimg.cn/blog_migrate/75626f4cc9727bf3981a22f9c26a514a.png)
填入你希望的用户名和登录密码
点击继续安装
如果出现下图,表示已经安装成功!
![](https://i-blog.csdnimg.cn/blog_migrate/96ade286c0f49d44469449e719971a56.png)
我们可以进入博客来看,也可以进入管理后台愉快的写文啦~
下次教如何让 Typecho 支持第三方登录(依托一个第三方插件)。