说实话，刚入行那会儿，我也觉得 amis 这玩意儿挺神，拖拖拽拽就能出后台。但后来接了几个大客户的单子，发现他们根本不敢把数据放公有云，非要搞内网隔离。这时候 amis本地部署 就成了刚需。很多新手一上来就想着去官网下最新包，结果配置半天跑不起来，或者启动后页面全是白屏，心态直接崩了。今天我不讲那些虚头巴脑的概念，就聊聊我在一线踩过的坑，怎么把 amis 稳稳当当跑在自己的服务器上。

先说个真事儿。去年有个做政务项目的兄弟，预算卡得死死的，又要求数据不出内网。他找外包，报价两万起步，还拖工期。后来我帮他看了下，其实就是个标准的 amis 本地部署 方案，成本几乎为零，只要服务器够硬。但这中间有个大坑，很多人忽略：版本匹配。amis 更新太快了，你用的 react 版本和 amis 的依赖冲突，能把你搞死。

第一步，环境准备。别整那些花里胡哨的 docker 镜像，对于中小企业或者内部工具，直接用 node 环境最实在。装个 node.js，版本建议 16 以上，别用 14，太老容易报错。然后全局装一下 create-ami-app，或者直接 clone 官方仓库。我推荐 clone 仓库，因为你能看到源码，方便改 bug。记住，git clone 的时候网络可能抽风，多试几次，或者用代理。

第二步，安装依赖。cd 进目录，npm install。这一步最磨人，特别是网络不好的时候，经常下载一半断了。这时候别慌，删掉 node_modules 和 package-lock.json，重新 npm install。如果还是不行，换淘宝镜像源，npm config set registry https://registry.npmmirror.com。这一步做不好，后面全是报错。我见过太多人在这步卡三天，最后发现是网络问题，真是服了。

第三步，配置本地服务。默认情况下，amis 是跑在开发环境下的。你要把它变成生产环境可用的，得改配置。打开 webpack 配置或者 vite 配置（取决于你用的构建工具），把 output 路径改对。更重要的是，后端接口怎么配？amis 本身是前端框架，它需要后端提供 JSON 配置。你得自己写个简单的 Node.js 或者 Python 服务，返回那个 JSON 数据。别指望 amis 能直接连数据库，它只是个壳。这里有个技巧，把接口地址写死在配置里，或者用环境变量，方便切换测试和生产环境。

第四步，打包部署。npm run build，生成 dist 文件夹。然后找个静态服务器，nginx 是最稳的选择。配置 nginx 指向 dist 目录，记得加个 try_files $uri $uri/ /index.html; 这行代码，不然刷新页面会 404。这一步看似简单，但很多人忘了配跨域，导致前端调不通后端接口。如果你的后端和前端不在同一个域名下，nginx 里得加 proxy_pass，把请求转发到后端服务。

最后，说说避坑。别盲目追求最新功能，stable 版本最靠谱。还有，amis 的组件库很大，按需引入能减小包体积，不然首屏加载慢得像蜗牛。我有个客户，页面加载要 10 秒，查了半天发现是引入了整个 amis 库，只用了几个组件。改成按需引入后，降到 2 秒，用户体验提升巨大。

总之，amis本地部署 不难，难的是细节。网上教程千篇一律，真正能解决问题的，都是那些踩过坑的人分享的。希望这篇能帮你省点时间，多陪陪家人，别天天加班改 bug 了。毕竟，代码是写不完的，生活还得继续。

本文关键词：amis本地部署