126 https://blog.126.li 一个现代化的内容管理系统 Thu, 26 Feb 2026 12:15:57 GMT https://validator.w3.org/feed/docs/rss2.html NeutralPress zh-CN 126 https://blog.126.li/icon/512x https://blog.126.li All rights reserved 2026, 126 <![CDATA[快速搭建NeutralPress]]> https://blog.126.li/posts/neutralpress https://blog.126.li/posts/neutralpress Thu, 26 Feb 2026 12:05:25 GMT 快速搭建NeutralPress

下面是一篇完整的 Markdown 格式的部署文章（根据官方 NeutralPress 文档整理，并补充必要的说明与流程），适合发布到你的博客上，用于指导如何将 NeutralPress 部署到 Vercel 云平台。(neutralpress.net)

将 NeutralPress 部署到 Vercel — 全流程指南

NeutralPress 是一个基于 Next.js 的现代 CMS，支持云端部署。Vercel 是 Next.js 官方推荐的主机平台，适合快速上线 NeutralPress 项目，并自动获得 CI/CD、全球 CDN 和自动构建能力。(neutralpress.net)

🚀 一、前期准备

在开始部署之前，请确认以下准备工作已经完成：

  • 你已经将 NeutralPress 仓库 Fork 到自己的 GitHub 账号；
  • 你有一个有效的 Vercel 账号（可以通过 GitHub / GitLab / Bitbucket 登录）；
  • 项目代码已推送到你的远程仓库；
  • 你了解项目可能需要的外部服务（如 PostgreSQL、Redis 等）。(neutralpress.net)

📌 二、登录并创建 Vercel 项目

  1. 打开 Vercel 官方网站（https://vercel.com）并使用你的账号登录。 (neutralpress.net)
  2. 在 Vercel 控制台点击 “New Project” → 选择 “Import From Git” → 连接你 Fork 的 NeutralPress 仓库。(neutralpress.net)
  3. 在导入设置中，确认仓库名称和要部署的分支（通常是 main 或 master）。

⚠️ 若仓库有子目录（例如 apps/web），请确保设置正确的部署目录。(neutralpress.net)

🧠 三、配置环境变量

NeutralPress 作为一个 CMS，需要连接数据库与缓存服务。因此需要配置运行环境变量：

  1. 在项目设置里找到 “Environment Variables”。
  2. 添加以下常见必要变量（视项目具体需求而定）：
DATABASE_URL=你的 PostgreSQL 链接
REDIS_URL=你的 Serverless Redis 链接
NEXT_PUBLIC_SITE_URL=https://你的域名或 .vercel.app 地址

注意：这些变量通常用于数据库连接、认证、站点配置等功能，必须填写正确才能正常运行。(neutralpress.net)

📦 四、导入数据库与缓存（可选）

如果你使用 Vercel 的 Storage 功能（如 Neon PostgreSQL、Redis Labs）：

  1. 在 Vercel 左侧菜单点击 “Storage” → 创建你需要的 PostgreSQL / Redis 实例。(neutralpress.net)
  2. 创建完成后复制生成的链接（如 DATABASE_URL, REDIS_URL）。
  3. 将这些链接分别粘贴到你在项目环境变量中的对应值。(neutralpress.net)

⚠️ 若不在 Vercel 内使用 Storage，请确保你已有可用外部数据库并复制好链接。(neutralpress.net)

🚢 五、部署项目

配置好变量后：

  1. 点击 Vercel 仪表板中的 “Deploy” 按钮。
  2. 等待 Vercel 进行构建与部署（通常几分钟内完成）。

部署过程中，Vercel 会：

  • 克隆你的仓库；
  • 安装依赖；
  • 运行构建命令；
  • 自动将站点托管到全球 CDN。

部署成功后，你会看到类似 https://your-project.vercel.app 的访问链接。

🌐 六、自定义域名（可选）

如果你有自己的域名：

  1. 在 Vercel Dashboard → Domains 添加你的域名；
  2. 根据提示配置 DNS（推荐使用 Vercel 的 Nameservers 或提供的 A / CNAME 记录）；
  3. 等待 DNS 生效（通常 5 ~ 30 分钟）。

🛠 七、部署优化与注意事项

📌 函数地区设置

默认情况下，Vercel 会选择 United States 作为函数部署地区。若你主要用户在其他地区（如亚洲）：

  • 在项目设置里调整 Functions Regions，让函数与数据库就近部署，提高访问速度。(neutralpress.net)

📌 构建失败分析

若构建失败：

  • 检查 Build Logs；
  • 确认所有环境变量配置无误；
  • 确保依赖正常安装。(LeaveWP)

🔁 每次部署

推送到 Git 仓库或修改环境变量都会触发新的部署。你可以在 Deployments 面板中查看历史记录、日志和重新部署。(Vercel)

🎉 完成上线！

现在，你的 NeutralPress 已经成功部署到 Vercel！

访问生产 URL，即可查看已上线的站点；后续提交新的代码将自动触发持续部署，让你的内容持续更新。(Vercel)

]]> 126