AI Agent智能体搭建从入门到实战

很多朋友想自己搭建一个 AI Agent 智能体平台，但总觉得门槛太高。
其实用开源项目 Dify，配合一台普通 Linux 服务器，按照下面的步骤走，十几分钟就能跑起来一个可用的智能体环境。
本文基于阿里云 2 核 4G 的 ECS（Ubuntu 22.04）操作，其他 Linux 发行版命令基本通用。

环境预备清单

你需要准备三样东西：

• 一台能联网的 Linux 服务器（推荐 2 核 4G 以上）
• SSH 客户端（Windows 用 PuTTY，Mac/Linux 直接用终端）
• 一个域名（非必需，但建议提前解析好，避免后期配置端口转发麻烦）

登录服务器后，先跑下面几个命令确认基础环境：

uname -a                # 查看内核版本
cat /etc/os-release     # 查看系统版本
df -h                   # 检查磁盘剩余空间（建议 20G 以上）

一条命令装上 Docker 和 Compose

Dify 依赖 Docker 运行，我们直接使用官方一键安装脚本：

curl -fsSL https://get.docker.com | bash -s docker

装完后把当前用户加入 docker 组（避免每次用 sudo）：

sudo usermod -aG docker $USER
newgrp docker

验证 Docker 是否正常：

docker version
docker compose version

能看到版本号说明环境就绪。
如果 docker compose 找不到，就装一下：

sudo apt install docker-compose-plugin -y

下载并启动 Dify 服务

用 git 拉取 Dify 的 docker-compose 配置（不要用 root 用户运行）：

git clone https://github.com/langgenius/dify.git
cd dify/docker

接着复制环境变量模板：

cp .env.example .env

dify/docker 目录下有一个 docker-compose.yaml，直接启动所有服务：

docker compose up -d

第一次启动会拉取镜像，根据网络情况可能需要 5-15 分钟。
当终端回到提示符后，查看容器状态：

docker compose ps

正常会看到几个容器状态都是 Up，其中 nginx、api、worker、db、redis 等。
如果某个容器状态是 Exited 或 Restarting，往下看避坑部分。

别掉进这些坑里

常见问题 1：80 端口被占用

Dify 默认用 80 端口，如果你的服务器上已经有 Nginx 或其他 Web 服务，启动会失败。
这时修改 docker-compose.yaml 中 nginx 容器的端口映射，比如改成 8080：

ports:
  - "8080:80"

然后重新 docker compose up -d。

常见问题 2：服务器内存不足

Dify 启动后大约占用 1.5-2G 内存，如果机器内存不够，可能会触发 OOM。
建议使用 swap 文件临时救急：

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

常见问题 3：镜像拉取超时

国内服务器拉取 DockerHub 镜像可能很慢，可以配置镜像加速器。
编辑 /etc/docker/daemon.json：

{
  "registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}

然后重启 Docker：systemctl restart docker，再重新执行 docker compose up -d。

跑一个对话测试看看成效

所有容器正常运行后，打开浏览器访问 http://服务器公网IP（或你配了域名的地址）。
看到 Dify 的注册/登录页面，说明部署成功。

用邮箱注册第一个管理员账号，登录后点击右上角「创建应用」，选择「对话型应用」，然后点「编排」进入工作流。
左侧选择模型供应商（比如 OpenAI），填入 API Key，就能在对话框中直接测试智能体回复了。
如果没配置模型，也可以先用内置的 GPT-3.5 测试（需要你提前准备好 OpenAI 或兼容的 API Key）。

如果你看到智能体能正常回复内容，那恭喜你——AI Agent 智能体搭建从入门到实战的第一步已经完成。
后续可以继续学习如何配置工具、知识库以及发布到生产环境。

总结与建议

本文演示了从一台裸机到 Dify 智能体平台运行的全过程。
遇到容器失败时，用 docker compose logs -f 查看实时日志，错误信息通常能直接定位问题。
如果你用的是宝塔面板，也可以在后台关闭 Nginx 的 80 端口占用，或单独配置反向代理。
完成基础搭建后，建议多尝试内置的提示词示例，熟悉 Agent 的思考流程。