Vibe Coding一人即团队系列54：云服务器 Node.js 与 MySQL 9 环境搭建及配置指南

纲要

环境准备与远程连接
- Windows 云服务器登录方式（VNC / RDP）
- 远程桌面连接配置与端口安全
基础运行环境安装
- Git 版本控制工具安装与验证
- Node.js 运行时与 npm 包管理器安装与验证
数据库服务部署
- Microsoft Visual C++ 运行库依赖安装
- MySQL 9 数据库服务器安装与配置
  - 自定义安装组件选择
  - 端口修改与安全策略
  - Root 密码设置与身份验证
  - Windows 服务注册与启动
- Navicat 数据库管理工具安装与激活
- 数据库连接测试
应用数据迁移
- 数据库字符集（UTF8MB4）与排序规则（unicode_ci）配置
- 数据结构与数据迁移（SQL 脚本导出与导入）
AI 编程辅助工具集成
- Claude Code CLI 工具全局安装与版本验证
- CCswitch 工具配置 MiniMax API 密钥
- VS Code 集成 Claude Code 插件配置与交互验证

环境准备与远程连接

在开始部署软件环境之前，首先需要建立与云服务器的远程连接。本文以 Windows Server 操作系统为例，演示通过远程桌面连接（Remote Desktop Protocol, RDP）登录服务器。

云服务商通常提供多种登录选项，包括 VNC（Virtual Network Computing）和 RDP。VNC 是一种较为传统的连接方式，目前仍可使用。推荐选用基于 RDP 的登录方式，该方式在网络条件良好时能提供更流畅的操作体验。

登录时，需使用管理员账户（默认为 Administrator）及对应的登录密码。远程桌面的默认连接端口为 3389。出于安全加固的考虑，建议在服务器防火墙或安全组策略中将默认端口修改为其他高位端口，以降低被自动化攻击程序扫描的风险。

若需将本地文件传输至服务器，可通过远程桌面连接直接拖拽文件至服务器窗口。但需注意，该方式存在文件大小限制。对于体积较大的安装包，建议通过服务器自带的浏览器从官方网站或可信镜像源进行下载。

基础运行环境安装

Git 版本控制工具

Git 是进行代码版本管理和后续依赖拉取的基础工具。在服务器上，可直接运行 Git 安装程序，按照默认选项（安装路径保持默认 C 盘）完成安装。

安装完成后，需验证 Git 是否已正确配置。可打开命令提示符（cmd）或 Windows 终端（PowerShell），执行以下命令：

bash 复制代码

git --version

若命令行正常输出版本号信息（如 git version 2.x.x），则表明 Git 环境已安装成功。

Node.js 运行时与 NPM 包管理器

Node.js 是基于 V8 引擎的 JavaScript 运行时环境，npm 是其默认的包管理工具，对于运行现代前端项目或 Claude Code 等 AI 工具至关重要。

运行 Node.js 安装程序（node-vxx.x.x-x64.msi），同样保持默认路径（C 盘）并完成安装向导。安装过程会自动将 Node.js 和 npm 添加至系统环境变量。

安装完毕后，必须重启命令提示符终端以使环境变量生效。随后，通过以下两个命令进行验证：

bash 复制代码

node -v
npm -v

若命令行分别输出了 Node.js 和 npm 的版本号，则说明 Node.js 环境已部署就绪。

数据库服务部署

依赖组件安装

在安装 MySQL 9 之前，若系统提示缺少运行库，需先安装 Microsoft Visual C++ Redistributable。这是 MySQL 服务器运行所必需的基础系统组件，请根据操作系统版本（x86/x64）安装对应的运行库。

MySQL 9 服务器安装与配置

相较于传统的 MySQL 8.0 版本，MySQL 9.0 引入了新的特性并优化了性能。安装过程需通过 MySQL Installer 进行。具体配置步骤如下：

安装类型选择 ：建议选择 Custom（自定义）模式，以便仅安装必要的 MySQL Server 核心组件，避免安装非必须的附加工具。
路径配置 ：默认安装路径为 C 盘。在实际生产或长期使用场景中，建议将程序目录和数据目录修改至其他数据盘（如 D 盘或 F 盘），以防止系统盘空间不足影响数据库稳定性。
网络与端口配置 ：MySQL 的默认端口为 3306。强烈建议 将此端口修改为其他高位端口（例如 33060 或 2206），因为默认端口常被互联网扫描工具探测，修改端口可有效避免针对 3306 端口的自动化暴力破解攻击。
身份验证与密码设置 ：设置 root 账户的密码。密码复杂度应包含大小写字母、数字和特殊字符，以增强安全性。请务必妥善保管此密码。
Windows 服务配置 ：将 MySQL 注册为 Windows 系统服务，服务名称可自定义（默认通常为 MySQL90）。配置服务为自动启动，以确保服务器重启后数据库自动恢复运行。
执行安装 ：确认配置无误后，点击 Execute 执行安装和初始化脚本。当所有配置项显示绿色勾选（Success）时，即表示配置完成。

安装完成后，可通过任务管理器 -> 服务，查找 MySQL90 服务，确认其状态为"正在运行"，以验证服务已成功启动。

Navicat 数据库管理工具安装

Navicat 是一款图形化的数据库管理工具，便于开发者可视化操作数据库。

安装：运行 Navicat 安装程序，按默认设置完成安装。
激活与配置 ：将补丁或注册文件复制到 Navicat 安装目录，完成激活。
连接测试 ：
- 打开 Navicat，选择连接 MySQL。
- 连接名称可自定义（例如 Server）。
- 主机（Host）填写 localhost 或 127.0.0.1。
- 端口填写安装时设置的端口号。
- 密码填写 root 账户密码。
- 点击"测试连接（Test Connection）"，若提示连接成功，则表明数据库服务与管理工具均已部署成功。

应用数据迁移

在服务器数据库为空的状态下，需要将本地开发数据库的数据结构和初始数据迁移至生产环境。

导出源数据 ：在本地 Navicat 中，右键点击源数据库，选择"转储 SQL 文件" -> "结构和数据"。此操作将生成包含完整表结构及数据记录的 SQL 脚本文件。相较于仅导出结构，导出完整数据可实现"拎包入住"式的环境迁移。
创建目标数据库 ：
- 在服务器 Navicat 中，新建数据库。
- 数据库名称：必须与源数据库名称保持一致。
- 字符集（Charset） ：选择 UTF8MB4。该字符集兼容完整的 UTF-8 编码，支持表情符号等特殊字符，是当前标准。
- 排序规则（Collation） ：选择 unicode_ci 或 utf8mb4_unicode_ci，以确保多语言数据的排序和比较准确性。
导入数据 ：
- 通过远程桌面将本地导出的 SQL 文件上传至服务器桌面。
- 在服务器 Navicat 中，右键点击已创建的目标数据库，选择"运行 SQL 文件"。
- 选择上传的 SQL 文件，点击 Start 执行脚本。
- 导入完成后，刷新数据库对象列表（Refresh），即可看到完整的表结构和数据记录。

AI 编程辅助工具集成

为了提升一人团队的开发效率，可在服务器端集成 Claude Code 等 AI 编程辅助工具。

Claude Code CLI 工具安装

Claude Code 是一个基于命令行的 AI 助手，可用于代码生成、重构和问题排查。

通过 npm 全局安装 Claude Code：

bash 复制代码

npm install -g @anthropic-ai/claude-code

安装完成后，验证版本：

bash 复制代码

claude --version

配置 API 密钥（以 MiniMax 为例）

若需接入国内大模型供应商（如 MiniMax），可使用 CCswitch 工具进行 API 密钥管理和模型切换。

下载并安装 CCswitch 客户端。
打开 CCswitch，点击"添加供应商"，选择 MiniMax。
填入从 MiniMax 开放平台获取的 API Key 和 Secret Key。
保持其他参数为默认，点击"添加"。若显示"添加成功"，则密钥配置生效。
在命令行中运行 claude。根据提示选择主题模式（如暗色模式 Dark）并信任工作区。此时，Claude Code 将能够识别并使用已配置的 MiniMax 大模型进行推理。

VS Code 插件集成

对于习惯在集成开发环境（IDE）中工作的开发者，可通过 VS Code 插件调用 Claude 能力。

在服务器端安装 VS Code。
打开 VS Code，进入扩展（Extensions）市场，搜索并安装 Claude Code 插件。
安装完成后，点击活动栏中的 Claude 图标，即可打开交互窗口。
输入测试问题（如"你是谁？"），若收到 AI 的正常回复（例如声明其是 MiniMax 模型），则说明 VS Code 端的 Claude Code 插件已配置成功。

API 速览

本节梳理了环境搭建过程中涉及的核心命令行接口（CLI）和工具接口。对于常规版本验证，主要依赖以下命令：

工具/软件	验证命令	预期输出	备注
`Git`	`git --version`	版本号（如 `2.40.0`）	用于版本控制
`Node.js`	`node -v`	版本号（如 `v20.10.0`）	JavaScript 运行时
`npm`	`npm -v`	版本号（如 `10.2.0`）	Node.js 包管理器
`Claude Code`	`claude --version`	版本号	AI 编程助手 CLI
`MySQL`（客户端）	`mysql -u root -p -P 3306`	进入 `mysql>` 交互终端	`-P` 参数需替换为实际端口

参考文档

官方文档

Node.js 官方文档：https://nodejs.org/en/docs/
MySQL 9.0 Reference Manual：https://dev.mysql.com/doc/refman/9.0/en/
Git 官方文档：https://git-scm.com/doc
Claude Code（Anthropic）：https://docs.anthropic.com/claude-code

参考链接

Navicat 产品手册：https://www.navicat.com/en/manual
Visual C++ Redistributable 下载：https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist

总结

本文详细阐述了在一台 Windows 云服务器上从零开始安装并配置 Node.js 环境、Git、MySQL 9 数据库、Navicat 管理工具，以及 Claude Code AI 编程助手的完整流程。

核心要点包括：基础环境安装 （Node.js与Git）、数据库安全配置 （修改默认端口与强密码策略）、数据迁移技术 （字符集统一与SQL脚本导入导出），以及 AI 编程工具链集成（CLI 与 IDE 插件）。