# AI2PG **Repository Path**: fsyz/AI2PG ## Basic Information - **Project Name**: AI2PG - **Description**: 目标:搭建一个本地多用户的 App Inventor 2 服务器。 用途:课堂教学、社团活动、兴趣学习。 优势: 1. 管理权限:用户管理、账号切换、资源打包; 2. 网络连接速度快; 3. 拥有配套服务; 4. 使用 PostgreSQL 保存用户文件和数据。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2026-10-27 - **Last Updated**: 2026-11-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README AI2PG 使用说明 ====================================================================== 一、项目介绍 ---------------------------------------------------------------------- 目标:搭建一个本地多用户的 App Inventor 2 服务器。 用途:课堂教学、社团活动、兴趣学习。 优势: 1. 管理权限:用户管理、账号切换、资源打包; 2. 网络连接速度快; 3. 拥有配套服务; 4. 使用 PostgreSQL 保存用户文件和数据。 重要提醒: 1. 每次退出前,请将自己的项目导出到本地做备份。 2. DATA 目录保存数据库数据,升级或维护时千万不要删除、移动或随意修改。 3. Win7 64 位环境尚未测试,建议使用较新的 Windows 64 位系统。 4. 默认账号密码仅用于首次登录,请登录后自行修改密码。 5. 建议仅在本地或可信局域网内使用,不要直接暴露到公网。 6. 数据库备份和还原请使用 PG操作 目录下的脚本完成,不要手动操作 DATA 目录。 7. 数据库备份文件默认保存在 PG操作\backups 目录。 项目说明:https://gitee.com/fsyz/README 本项目使用 PostgreSQL 保存用户文件和数据。 二、软件版本 ---------------------------------------------------------------------- App Inventor 2 编译版本:v185a-1537-gb09719390-fsyzty Use Companion:2.81 或 2.81u 源码地址:https://github.com/mit-cml/appinventor-sources OpenJDK:17.0.20+8 下载地址:https://mirrors.tuna.tsinghua.edu.cn/Adoptium/17/jdk/x64/windows/ PostgreSQL:18.6-5 下载地址:https://www.enterprisedb.com/download-postgresql-binaries 三、首次运行步骤 ---------------------------------------------------------------------- 以下操作建议在 AI2PG 根目录下进行。 1. 初始化数据库 运行:PG操作\PG_初始化.bat 作用:初始化数据库,生成 DATA 目录。 完成后关闭程序窗口。 2. 启动数据库并初始化 appinventor_db 运行:DevStart.bat 作用:启动数据库,初始化 appinventor_db,生成表。 注意:该窗口需要保留,不要关闭。 3. 添加默认用户 运行:PG操作\PG_添加3用户.bat 将添加以下 3 个用户: 角色 用户名 密码 管理员 admin admin 普通用户 User User 测试用户 test test 完成后关闭该窗口。 4. 登录网站 浏览器访问:http://127.0.0.1:8888 使用上面的账号登录。 请登录后自行修改 3 个用户的密码,尤其是管理员账号。 四、日常启动与停止 ---------------------------------------------------------------------- 启动: 第二次及以后,只需运行:DevStart.bat 保持窗口开启。关闭该窗口通常会导致服务停止。 停止: 1. 关闭 DevStart.bat 窗口; 2. 运行:DevStop.bat 查看停止结果,确认数据库和服务状态。 注意:停止脚本名为 DevStop.bat,请以实际文件名为准,不要随意改名。 五、访问方式 ---------------------------------------------------------------------- 本机访问: http://127.0.0.1:8888 局域网其他电脑访问: http://服务器局域网IP:8888 例如:http://192.168.1.100:8888 如果局域网无法访问,请检查: 1. DevStart.bat 窗口是否仍在运行; 2. 服务器防火墙是否放行 8888 端口; 3. 客户端与服务器是否在同一网络; 4. 访问地址是否使用了正确的服务器 IP; 5. 8888 端口是否被其他程序占用。 六、用户与密码管理 ---------------------------------------------------------------------- 默认用户: 管理员:admin / admin 普通用户:User / User 测试用户:test / test 首次登录后请立即修改默认密码。 管理员可在用户管理相关页面进行用户管理。 本项目在官方源码基础上增加了批量添加用户按钮,便于课堂教学时批量创建账号。 七、备份建议 ---------------------------------------------------------------------- 1. 项目备份 每次退出前,用户应将项目导出到本地保存。 不要只依赖服务器中的数据。 2. 数据库备份 备份与导出流程如下: (1) 关闭 DevStart.bat 窗口; (2) 运行:PG操作\PG_启动.bat 启动数据库,不关闭窗口; (3) 使用 PG操作\PG_备份.bat 完成备份。 备份文件默认保存在:PG操作\backups 建议将备份文件另行保存到本地或其他安全位置。 DATA 目录保存 PostgreSQL 数据,不要手动删除、移动或随意修改。 不要用复制 DATA 目录的方式代替数据库备份。 3. 配置文件备份 升级或修改端口前,备份以下文件: http.ini appinventor.ini 以及其他自行修改过的文件。 八、升级方法 ---------------------------------------------------------------------- 0. 备份数据库: 关闭 DevStart.bat 窗口; 运行 PG操作\PG_启动.bat 启动数据库,不关闭窗口; 使用 PG操作\PG_备份.bat 完成备份; 确认 PG操作\backups 目录中已生成备份文件; 备份完成后再停止数据库进行升级。 1. 备份自己修改过的文件,例如: http.ini appinventor.ini 其他自定义配置文件; 2. 下载新版本并解压; 3. 覆盖原目录; 4. 将之前备份的修改文件覆盖回去; 5. 启动 DevStart.bat 验证服务。 特别注意: 数据在 DATA 目录中,升级时千万别动这个目录。 不要用新版本的 DATA 覆盖旧数据。 升级前请确认 PG操作\backups 中的数据库备份文件已妥善保存。 九、修改网站端口:8888 改为 80 ---------------------------------------------------------------------- 如需将网站端口从 8888 改为 80,按以下步骤操作: 1. 修改 http.ini 打开:AI2PG\DevServer\start.d\http.ini 修改:jetty.http.port = 80 2. 修改 appinventor.ini 打开 appinventor.ini,将其中 2 处 8888 修改为 80。 修改完成后重启服务。 访问地址变为:http://127.0.0.1 或:http://服务器局域网IP 注意: 80 端口可能被 IIS、Apache、Nginx 等程序占用,修改前请确认端口可用; 在 Windows 上使用 80 端口可能需要管理员权限。 十、AI 伴侣 ---------------------------------------------------------------------- companions 目录下包含: MITAI2Companion.apk 用途:手机、平板在 Wi-Fi 情况下使用。 emulator.apk 用途:官方 MIT_App_Inventor_Tools 软件使用。 MIT_App_Inventor_Tools 网址:https://appinventor.mit.edu/explore/ai2/windows uemulator.apk 用途:桌面版 AI 伴侣使用。 桌面版 AI 伴侣项目地址:https://gitee.com/fsyz/AICompanion 使用方法:删除 AINEW_USB\vendor\chromium\crx 目录中的 apk,将 uemulator.apk 放进去。 十一、本项目相对官方源码的改动 ---------------------------------------------------------------------- AI2PG 由 MIT App Inventor Public Open Source 编译而成, 在官方源代码基础上做了如下修改: 1. AdminUserList.java:增加了一个批量添加用户的按钮。 2. LoginServlet.java:修正中文出错信息提示。 3. BuildServer.jar 超过 100M,无法上传 Gitee,拆分为 BuildServer.jar1 和 BuildServer.jar2, DevStart.bat 会自动合并。 4. appinventor.ini:网站参数调整。 5. appinventor.tpl:修改 appinventor.war 为 appinventor。 6. java.mail.jar:使用 1.6.2 版代替原来的 1.4。 7. index.jsp:默认跳转到中文界面。 8. login.jsp:添加 MITAI2Companion.apk 下载链接。 9. OPENJDK\lib\modules 超过 100M,拆分为 modules1 和 modules2,DevStart.bat 会自动合并。 十二、常见问题排查 ---------------------------------------------------------------------- 1. 浏览器打不开网站 检查: DevStart.bat 是否运行且窗口未关闭; 是否访问 http://127.0.0.1:8888; 8888 端口是否被占用; 防火墙是否拦截; 数据库是否已初始化成功。 2. 登录失败 检查: 是否已运行 PG_添加3用户.bat; 用户名和密码大小写是否一致; 是否已修改密码但忘记新密码; 数据库是否正常启动。 3. 局域网无法访问 检查服务器 IP、防火墙、端口放行情况, 并确认客户端与服务器在同一局域网。 4. 升级后配置失效 升级覆盖可能覆盖自定义配置, 请将备份的 http.ini、appinventor.ini 等文件恢复。 5. 服务无法停止或端口仍被占用 关闭 DevStart.bat 后运行 DevStop.bat 查看结果。 如仍被占用,可重启计算机或检查是否有残留 Java/PostgreSQL 进程。 6. 数据库还原 还原流程如下: (1) 关闭 DevStart.bat 窗口; (2) 运行:PG操作\PG_启动.bat 启动数据库,不关闭窗口; (3) 先使用 PG操作\PG_备份.bat 备份当前数据库,防止误覆盖; (4) 使用 PG操作\PG_还原.bat 完成还原。 备份文件默认位于:PG操作\backups 还原时选择 PG操作\backups 目录中的备份文件,确认无误后再执行还原。 还原完成后关闭 PG_启动.bat 窗口,重新运行 DevStart.bat, 并登录网站验证用户和项目数据是否正常。 还原过程中不要手动修改 DATA 目录。 十三、安全与使用建议 ---------------------------------------------------------------------- 1. 首次登录后立即修改默认密码; 2. 建议只在本地或可信局域网使用; 3. 不要将服务直接暴露到公网; 4. 定期备份项目、数据库和配置文件; 5. 不要随意删除 DATA 目录; 6. 修改配置前先备份原文件; 7. 备份或还原数据库时,先关闭 DevStart.bat, 再用 PG操作\PG_启动.bat 单独启动数据库; 8. Win7 64 位尚未测试,生产使用建议采用受支持的系统环境; 9. 数据库还原前必须先用 PG操作\PG_备份.bat 备份当前数据, 确认还原文件无误后再执行 PG操作\PG_还原.bat; 10. 数据库备份和还原统一使用 PG操作 目录下的脚本完成, 不要手动操作 DATA 目录; 11. 数据库备份文件默认保存在 PG操作\backups, 请定期将该目录中的备份复制到其他安全位置。 十四、补充说明 ---------------------------------------------------------------------- https://github.com/mit-cml/appinventor-sources/commit/5100c1b11f6efd67736f02d7307f0b7e22adcb80 2026 年 10 月 16 日开源代码更新之后, 将数据存放在 PostgreSQL,不必使用 Google App Engine 了。 ======================================================================