MattWu.cc
← 返回项目目录

从任何电脑开始做项目

先选你现在要做什么，再按步骤走。拿不准时，复制提示词给 AI。

1. 打开一个专用文件夹

在当前电脑建立一个清楚命名的目录，例如 ~/Projects/my-project（Mac / Linux 示例）。Windows 可用自己的“项目”文件夹。

在 Codex 或 Claude Code 中打开这个文件夹，然后复制下面的提示词，填入项目用途。先确认“当前电脑”和“当前目录”，再开始写代码。

2. 先做能预览的最小版本

告诉 AI：谁来使用、需要什么功能、是否需要登录或保存数据。先在本机看见效果，再决定发布到哪里。

本地预览地址里的 localhost 指当前运行程序的那台电脑；在 VPS 启动的 localhost 不能直接当成小Mac的 localhost，远程预览要使用合适的端口转发。

3. 用 Git 管代码，用 GitHub 保存远程副本

Git 保存修改历史；GitHub 仓库便于备份、换电脑与协作。先配置 .gitignore，再提交代码。自用项目默认建议私有仓库。

GitHub 上有代码不代表网站已经运行，也不代表数据库、素材和密钥已经备份。

4. 根据项目要求选择运行位置

Cloudflare Workers：适合兼容 Workers 运行环境的网站、API、定时任务。需要保存数据时，再按需要选 D1、KV 或 R2。

VPS：适合需要常驻进程、Docker、自定义系统软件或现有服务器环境的服务。由进程管理器或容器维持运行，并配置备份。

本地电脑：适合依赖本地素材、设备或桌面程序的工具，例如 digital guy 和 PixelUpload；关机后本地任务通常也会停止。

让 AI 说明选择依据和费用影响，不必为了新项目同时安装所有这些东西。

5. 接域名，验证，再留档

Cloudflare 项目按实际部署方式配置域名或路由；VPS 网站先确认服务可用，再配置 DNS 和反向代理。下方有两条路线的解释。

发布后用正式网址检查登录、主要功能和保存数据。写清源码在哪、怎样启动、怎样发布、怎样备份，并把入口加入 mattwu.cc。

复制给 Codex / Claude Code

看懂你的部署方式

Cloudflare 云端项目

域名 → Worker / Pages → 按需连接数据

官网 · 收租系统 · 心理花园 · EMDR
VPS 上的项目

域名 → VPS 反向代理 → 应用服务

Marknote · 阅读器 · 快记 API

这套东西叫什么

可以叫“项目开发与部署流程”：在电脑上写代码，保存到仓库，发布到运行环境，再用域名访问。

  • 文件夹：当前电脑上的源码和项目文件。
  • Codex / Claude Code（CC）：协助读代码、修改项目和执行任务的工具；工作范围取决于当前打开的目录和连接的机器。
  • Git / GitHub：修改历史与远程代码仓库。
  • Cloudflare：提供 DNS、代理、Workers、Pages 和存储等服务的平台。
  • Workers：在 Cloudflare 云端运行代码。Serverless 的意思是无需自己维护那台服务器，服务仍然有实际运行平台。
  • Pages：Cloudflare 的网站托管产品；你的 EMDR 使用它。
  • D1 / KV / R2：分别用于关系数据、键值数据和文件对象；按需选择。
  • VPS：自己管理的远程电脑，用来运行服务。
  • 域名 / DNS：好记的网址，以及告诉网络该去哪里的记录；域名本身不保存项目代码。
  • 反向代理：接住网页请求，再转给对应的后端服务。
  • Nginx Proxy Manager（NPM）：管理 Nginx 反向代理与 HTTPS 的界面。它与安装 JavaScript 依赖的 npm 命令不是同一个东西。

你的 NPM 现在还在用吗

还在运行。 2026-10-01（UTC）只读核对：VPS 上的 Nginx Proxy Manager 容器正在运行，监听 80 / 443；配置中仍有 Marknote、阅读器和快记 API 的转发。

不是所有域名都经过它。 官网 mattwu.cc 的当前 Worker 代码直接响应页面；收租系统、心理花园也在 Cloudflare 云端。旧 NPM 中仍能看见 mattwu.cc 的历史条目，不代表官网当前需要经过旧服务。

配置存在也不等于上游服务健康；某些已退役项目仍留有旧代理条目。排障时要结合实际部署、DNS / 路由和服务状态。

路线 A：Cloudflare 上运行

浏览器 → Cloudflare 域名 / 路由 → Worker（按需连接 D1 / KV / R2）。

新建独立 Worker 网站时可使用 Custom Domain，让 Worker 成为该域名的源站；已有项目保留并核对现有配置。mattwu.cc 当前采用 mattwu.cc/* Worker Route，不必为写指南更改它。

Route 也可以用于在已有源站前运行 Worker；是否继续访问 VPS，取决于 Worker 代码和路由，不是看到 Cloudflare 就能判断。

参考：Cloudflare Custom Domains 与 Worker Routes。

路线 B：VPS 上运行

浏览器 → 域名 DNS（开启橙云时先经过 Cloudflare 代理）→ VPS 的 NPM → 对应端口上的应用。

DNS 记录指向服务器，并不直接选择应用端口；NPM 根据域名转发到目标服务，并可管理 HTTPS。Cloudflare 橙云代理与 VPS 上的反向代理可以同时使用。

你的 Marknote、阅读器和快记 API 属于 VPS 服务；给这类应用新增网址时，要核对现有 DNS、代理目标、服务端口与证书。当前不需要为了这份指南停用或替换 NPM。

参考：Nginx Proxy Manager 官方说明。

新电脑能做什么，取决于拿到了什么

使用网站：网址和登录权限。

继续开发：源码、开发环境、所需配置及数据；有些工具还需要特定系统或设备。

发布上线：部署平台权限、项目配置与发布流程。

连接 VPS：网络与 SSH 登录权限。具体主机信息在私有笔记《主机与 VPS 访问方式》中查看。

克隆仅取得仓库中的文件和历史；参考 GitHub 克隆仓库说明。

每个项目都留一张“启动卡”

  • 名称与用途；项目网页入口。
  • 源码所在电脑、真实目录、GitHub 仓库。
  • 运行位置：Cloudflare / VPS / 本地电脑。
  • 本地启动、预览网址、停止方式和必要设备。
  • 环境版本、环境变量名称及私有配置获取方式。
  • 检查与发布命令；是否已配置自动部署。
  • 域名 → Worker 或 VPS 反代 → 实际服务。
  • 数据位置、备份和恢复方式；最近核实日期。

这张卡放在项目 README，并同步到 Marknote 的项目档案；官网保留便于查找的入口和不含凭证的说明。

本次参考的你的笔记

Marknote →《VPS 服务总览》《主机与 VPS 访问方式》《域名》《Cloudflare》。域名笔记主要记录注册与到期事项；Cloudflare 笔记含账户相关资料，不能直接复制到公开官网。

打开 Marknote 后按标题搜索。公开指南只保留流程和已核实的架构说明。