本地部署开源 AI 工具前的环境准备

本地部署开源 AI 工具前，建议先整理一份环境清单：操作系统版本、Docker、Node、Python、Git、数据库、反向代理、可用端口、网络代理和 API Key。很多部署失败并不是项目本身问题，而是环境基础不稳定。

实践要点

第二步是隔离测试。优先使用 Docker 或独立虚拟环境，避免多个项目抢同一个依赖版本。涉及数据库和上传目录的项目，要先确认备份和迁移路径，避免测试数据污染正式环境。

第三步是记录每次修改。包括安装命令、配置文件、端口映射、账号权限和错误日志。后续需要复现、二开或迁移时，这些记录比临时截图更有价值。

后续内容

这是一篇种子文章，后续会围绕“本地部署开源 AI 工具前的环境准备”补充更完整的操作截图、命令、配置示例和问题排查记录。