从零到一：企业级AI Town本地化部署与私有社区搭建指南
项目地址: https://gitcode.com/gh_mirrors/ai/ai-town 你是否正在寻找一种低成本、高可控的方式搭建企业内部虚拟社区？还在为云服务的隐私风险和长期成本担忧？本文将带你通过AI Town实现完全本地化部署，打造专属于你的企业级虚拟互动空间，无需依赖外部云服务，全程自主可控。
读完本文你将掌握：
- 本地化部署AI Town的完整流程（Docker容器化方案）
- 私有环境下LLM模型集成与优化
- 企业定制化虚拟世界构建（角色/场景/交互规则）
- 生产环境部署与运维最佳实践
项目概述：什么是AI Town？
AI Town是一个MIT许可的开源项目，提供了构建虚拟社区的完整框架，允许AI角色在虚拟空间中生活、聊天和社交。该项目基于《Generative Agents: Interactive Simulacra of Human Behavior》研究论文开发，特别优化了JS/TS生态系统，使其更适合Web开发者构建和扩展。
核心功能模块：
- AI角色系统：convex/aiTown/agent.ts
- 世界模拟引擎：convex/aiTown/world.ts
- 交互系统：convex/aiTown/conversation.ts
- 地图与场景管理：convex/aiTown/worldMap.ts
本地化部署前置准备
硬件环境要求
| 组件 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU | 4核 | 8核或更高 |
| 内存 | 16GB | 32GB（用于LLM本地运行） |
| 存储 | 100GB SSD | 200GB NVMe SSD |
| GPU | 无（基础功能） | NVIDIA RTX 3090/4090（本地LLM加速） |
软件环境依赖
本地化部署完整流程
1. 获取项目源码
git clone https://gitcode.com/gh_mirrors/ai/ai-town.git
cd ai-town
2. Docker容器化部署（推荐）
Docker Compose方案提供了完整的本地化环境，包含前端、后端和数据库组件：
# 构建并启动所有服务
docker compose up --build -d
# 查看服务状态
docker compose ps
服务启动后，你可以通过以下地址访问：
- 前端应用：http://localhost:5173
- 后端API：http://localhost:3210
- 管理面板：http://localhost:6791
首次启动需要生成管理员密钥：
docker compose exec backend ./generate_admin_key.sh
将生成的密钥保存到.env.local文件：
# 在.env.local中添加
CONVEX_SELF_HOSTED_ADMIN_KEY="你的管理员密钥"
CONVEX_SELF_HOSTED_URL="http://127.0.0.1:3210"
3. 初始化系统数据
# 设置初始数据
npm run predev
# 启动后端服务
npm run dev:backend
本地化LLM集成配置
Ollama本地模型部署
AI Town默认使用Ollama运行本地大语言模型，推荐使用Llama 3模型：
# 安装Ollama
curl -fsSL https://ollama.com/install.sh | sh
# 启动Ollama服务
ollama serve &
# 拉取并运行Llama 3模型
ollama pull llama3
ollama run llama3
配置Docker与Ollama通信
# 设置Ollama连接地址
npx convex env set OLLAMA_HOST http://host.docker.internal:11434
# 测试连接
docker compose exec backend curl http://host.docker.internal:11434
如果返回"Ollama is running"则表示连接成功。
企业虚拟社区定制指南
1. 自定义角色与人物设定
修改数据文件定义企业专属角色：
// data/characters.ts示例
export const characters = [
{
name: '张经理',
textureUrl: '/assets/32x32folk.png',
spritesheetData: f1SpritesheetData,
speed: 0.1,
// 角色背景故事
description: "技术部门经理，10年企业信息化经验，喜欢讨论AI应用场景...",
},
// 添加更多角色...
];
角色形象使用精灵图定义，支持多种动作状态。
2. 定制虚拟办公场景
使用Tiled地图编辑器创建企业专属场景：
- 下载Tiled地图编辑器
- 编辑自定义地图并导出为JSON格式
- 使用转换脚本处理地图文件：
node data/convertMap.js <你的地图文件> <资源路径> 16 16
- 更新初始化文件加载新地图
3. 配置企业专属交互规则
修改交互处理逻辑定义企业特有的互动规则：
- 工作汇报流程
- 项目协作机制
- 会议室预订系统
- 企业知识库查询
生产环境部署与运维
服务器安全加固
- 配置防火墙，只开放必要端口
- 设置HTTPS加密（使用Let's Encrypt）
- 定期更新Docker镜像：
# 更新所有服务镜像
docker compose pull
docker compose up -d
性能监控与优化
- 启用Convex性能监控：
npx convex dashboard
数据备份策略
# 创建数据备份
npx convex export > backup-$(date +%Y%m%d).json
# 恢复数据
npx convex import backup-20250101.json
建议设置定时任务自动备份重要数据。
常见问题解决
服务启动失败
检查Docker服务状态和日志：
# 查看服务日志
docker compose logs -f backend
# 重启服务
docker compose restart backend
Ollama连接问题
如果Docker容器无法连接Ollama：
# 进入容器测试网络连接
docker compose exec backend /bin/bash
curl http://host.docker.internal:11434
性能优化建议
总结与展望
通过本指南，你已成功在本地环境部署了企业级AI Town虚拟社区。该方案不仅提供了数据隐私保护和成本控制，还支持深度定制以满足企业特定需求。
后续可探索的方向：
- 集成企业SSO认证系统
- 对接内部知识库与CRM系统
- 开发专属业务流程模拟模块
- 构建数据分析面板监控社区活跃度
项目完整文档：README.md
技术支持：项目社区讨论区
希望这份指南能帮助你构建高效、安全的企业虚拟互动空间，提升团队协作效率与创新能力。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
