🔥 如何快速搭建企业级APP内网发布平台？App-Host完整部署指南
项目地址: https://gitcode.com/gh_mirrors/ap/app-host App-Host是一款开源的企业级应用内网发布平台，专为iOS和Android应用的测试包管理设计。作为类似fir.im的本地化解决方案，它支持内网部署确保项目安全，同时提供APP包上传、渠道管理、权限控制等核心功能，帮助团队高效分发测试应用。
📌 为什么选择App-Host？核心优势解析
✅ 企业级安全保障
- 支持完全内网部署，避免测试包泄露风险
- 基于MIT许可证开源，可自定义安全策略
- 用户权限分级管理，细粒度控制访问范围
✅ 全平台应用管理
- 无缝支持iOS (IPA) 和Android (APK) 包解析
- 自动提取应用信息：iOS证书类型、UDID、Android签名信息
- 多渠道管理：可创建生产/测试/越狱等不同环境渠道
✅ 灵活部署方案
- Docker一键部署，5分钟完成环境搭建
- 源码编译选项，支持深度定制开发
- 兼容主流服务器系统，轻量级资源占用
🚀 3种部署方式任选：从新手到专家
1️⃣ Docker公有镜像（推荐新手）
最简单的部署方式，适合快速尝鲜和生产环境使用：
# 1. 授权Docker访问~/shared目录（Docker偏好设置→资源）
# 2. 启动容器
docker run --name app_host -v ~/shared:/app/shared -p 3000:8686 -d tinyc/app-host:lastest
访问 http://localhost:3000 即可使用，数据自动保存在宿主机~/shared目录。
2️⃣ Docker源码编译（适合开发者）
需要自定义配置或贡献代码时选择：
# 1. 克隆仓库
git clone https://gitcode.com/gh_mirrors/ap/app-host.git /opt/app-host
# 2. 进入项目目录
cd /opt/app-host
# 3. 构建并启动
./docker/launcher bootstrap -v
./docker/launcher start
⚠️ 注意：bootstrap步骤依赖网络，若失败可重试几次
3️⃣ 源码直接运行（高级用户）
适合需要深度定制的场景，需本地安装Ruby环境：
git clone https://gitcode.com/gh_mirrors/ap/app-host.git /opt/app-host
cd /opt/app-host
# 生成密钥
rake secret
# 修改配置文件
vi config/secrets.yml # 更新production下的secret_key_base
# 安装依赖
bundle install
# 启动服务
rails s
📱 平台界面预览：直观高效的操作体验
应用管理控制台
App-Host应用列表界面，支持应用创建、归档和渠道管理
应用详情与版本管理
显示应用基本信息、版本历史和下载统计，支持多渠道并行管理
包上传与信息解析
上传界面支持拖拽操作，自动解析APP元数据，如iOS UDID和Android签名信息
⚙️ 关键配置与最佳实践
🔒 HTTPS配置（iOS必需）
苹果要求OTA安装必须使用HTTPS，推荐使用Nginx反向代理：
# 配置示例位置：docker/nginx.conf
server {
listen 443 ssl;
server_name ota.yourcompany.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_set_header X-Forwarded-Proto https;
proxy_pass http://docker服务地址:3000;
}
}
📂 核心目录结构说明
- 应用代码：app/controllers/ - 包含应用核心业务逻辑
- 数据库配置：config/database.yml - 数据库连接设置
- 上传适配器：app/uploaders/ - 文件上传处理模块
- 解析模块：lib/parsers/pkg_adapter/ - IPA/APK解析实现
❓ 常见问题解决方案
🚫 IPA无法安装怎么办？
- 确认已配置HTTPS（苹果强制要求）
- 检查UDID是否已添加到企业证书
- 验证config/secrets.yml中的HTTPS相关配置
📱 APK图标显示异常？
目前不支持XML格式图标解析，建议使用PNG格式图标文件。
📄 许可证与贡献
App-Host基于MIT许可证开源，欢迎通过提交PR参与项目改进。核心功能开发可参考：
👥 关于作者
项目维护者信息，欢迎技术交流
通过App-Host，团队可以告别繁琐的测试包分发流程，实现规范化的应用管理。无论是初创公司还是大型企业，都能找到适合自己的部署方案。立即尝试，5分钟搭建专属的APP内网发布平台！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
