appsmith 必须用 docker compose up -d 启动，依赖官方 docker-compose.yml 和 docker 2.0+ 环境；需配置 appsmith_server_url、反向代理及正确证书，否则前端资源加载失败或登录静默失败。

docker compose up -d 是唯一受支持的安装方式，别折腾源码编译或 npm 启动——那些路径根本跑不起来。

确认 Docker 环境是否真就绪

很多人卡在第一步：看似装了 Docker，但 docker compose version 报错或版本过低。Appsmith 要求 docker ≥ 2.0、docker compose（不是旧版 docker-compose）也 ≥ 2.0。

• Ubuntu/Debian 上，sudo apt install docker.io docker-compose 安装的往往是旧版，建议走 Docker 官方 repo 或用 curl https://get.docker.com | sudo sh + sudo apt install docker-compose-plugin
• 运行 docker info 看 Storage Driver 是否为 overlay2；磁盘空间至少留 2GB，Appsmith 镜像加数据卷合计占约 1.2GB
• 普通用户必须加入 docker 组：sudo usermod -aG docker $USER，然后完全退出终端重登，否则 docker compose up 会权限拒绝

拉配置、启服务，三步不能少

别自己写 docker run 命令，官方 docker-compose.yml 已打包 PostgreSQL、Redis、Nginx，手动拼接大概率导致静态资源 404 或 WebSocket 断连。

docker-container-rerun-all

顺序检查并可选更新所有已在长期记忆中记录了固定重建命令的 docker run 容器。使用场景：用户...

下载

• 创建干净目录：mkdir -p ~/appsmith && cd ~/appsmith
• 下载最新稳定版配置：wget https://raw.githubusercontent.com/appsmithorg/appsmith/release/deploy/docker/docker-compose.yml（注意是 release 分支，不是 main 或 refs/heads/release 这类错误路径）
• 启动：docker compose up -d（不是 docker-compose），等 1–2 分钟后执行 docker compose ps，看到 appsmith-server、postgres、redis 全是 running 才算成功

为什么 localhost:8080 能打开，但局域网其他机器打不开？

因为默认只监听 127.0.0.1:8080，硬改 ports 暴露 8080 是最常见错误——这会绕过 Appsmith 内置 Nginx，导致前端资源加载失败。

• 正确做法：编辑 docker-compose.yml 中 appsmith-server 的 environment 区块，添加两行：
  APPSMITH_ENFORCE_SECURE_COOKIES: "true"
APPSMITH_SERVER_URL: "https://your-domain.com"（没域名先填 http://your-server-ip，HTTPS 待反向代理补上）
• 必须配反向代理（Nginx/Caddy），让 TLS 终止在代理层，再把请求转发给容器内 8080；直接暴露容器端口 = 放弃 WebSocket 和静态资源完整性
• 首次访问若提示 “Invalid Host header”，说明 APPSMITH_SERVER_URL 值和浏览器地址栏不一致，比如填了 https://app.example.com 却用 http://192.168.1.100 访问

本地开发想改前端代码？别直接 npm start

Appsmith 前端依赖后端 API、Redis 会话、PostgreSQL 数据库，跳过 Docker 直接 yarn start 必然报 Connection refused 或登录页空白。

• 改前端必须走完整容器栈：保持 docker compose up -d 运行，再进 appsmith/client 目录，按官方文档启用热更新模式（需提前生成证书、配 /etc/hosts）
• 证书必须用 mkcert 生成，且域名得是 dev.appsmith.com，否则现代浏览器会拦截混合内容
• 环境变量文件 .env.local 里要设 REACT_APP_BACKEND_API_BASE_URL=http://localhost:8080/api/v1，不然前端发请求会指向错地址

外网访问真正卡点不在启动，而在 APPSMITH_SERVER_URL 与反向代理配置的严格一致性——填错一个字符，整个登录流程就会静默失败，连错误日志都不明显。