Files
intranet_app_manager/README.md
T
2022-02-23 17:06:52 +08:00

105 lines
2.6 KiB
Markdown

# 安装指南
#### 介绍
本项目使用 Spring Boot 开发的类似蒲公英和fir的企业内网 APP 分发平台,解决下载限制,实名认证等繁琐过程。
#### 效果
样式与 fir 一致,直接扒的。
##### 首页
![首页](images/index.jpg)
##### 更新列表
![首页](images/list.jpg)
##### 基本信息
![](images/list_info.jpg)
##### 钉钉集成
![](images/list_web_hook.jpg)
##### 钉钉机器人消息
![](images/ding_ding.jpg)
##### PC安装页
![首页](images/install.jpg)
##### 手机安装页
![首页](images/mobile_install.jpg)
##### Jenkins 集成效果
![](images/jenkins_code.jpg)
##### 证书信任设置
![首页](images/install_crt.gif)
#### 安装教程
项目使用 JAVA 开发,需要 JDK 1.8 运行环境,数据库使用的是 Mysql,需要安装 Mysql。JDK 安装直接找网上教程。
##### HTTPS 证书
参考 [Spring Boot Https 证书](Spring_Boot_Https_证书.md) 创建证书,本项目使用的是 `pckcs12`,密码使用的是 `123456`,部署项目时证书需要自己创建。
#### 部署
本项目使用的是 8080 和 443 端口,确保端口未被占用。可以配置文件中更改为别的端口。
> 启动服务
```shell
git clone https://github.com/yizhaorong/intranet_app_manager.git
cd intranet_app_manager
#docker方式启动
sh deploy.sh docker
#直接在终端启动(仅实现了Mac端,其它端未试)
sh deploy.sh
```
服务启动后即可输入你的 IP 或域名来访问。
> 上传与安装
可以将 ipa 或 apk 拖入上传块中进行上传,上传完成后会在列表中展示。
**注意**
本项目默认采用 http 方式访问,这样可以避免没必要的证书信任。iOS 安装需要使用 https 协议,由于内网部署是用的自建证书,需要将 ca 添加到设备的信用列表中才可正常进行安装。**设置抓包代理会影响自建证书**,导致无法下载。
#### Jenkins 集成
集成会用上 Jenkins 展示 HTML,需要在 Jenkins 配置中打开 HTML 展示
![html](images/jenkins.jpg)
> 上传脚本
```shell
# 上传到APP管理平台
result=$(curl -F "file=@$WORKSPACE/build/Ewt360_debug/Ewt360.ipa" -F "token=ec7551847a2faa3988172e648d554c20" http://172.16.241.203/app/upload)
code_url=$(echo $result | sed 's/.*\(http.*\)",.*/\1/g')
echo "code_url="$code_url > $WORKSPACE/code.txt
```
> 注入变量
Properties File Path:`$WORKSPACE/code.txt`
> 展示二维码
Description: `<a href="${code_url}" target="_blank"><img src='${code_url}' height="160" width="160" /></a>`
![shell](images/shell.jpg)
![code](images/code.jpg)