AppServer

简介

基于Sanic搭建的简单App在线下载、安装服务器。可在线下载安装包, 或者iPhone在线安装ipa。

首页

上传App

App详情页

App编辑页

功能

[x] RESTful的API
[x] 上传apk、ipa文件
[x] 下载apk、下载ipa
[x] 短链接进入下载页
[x] App、版本管理
[x] 搜索App
[ ] HTML更好兼容移动端

更多...

使用

环境

Python > 3.5
macOS 10.12+
centos 6+
ubuntu 14.04+
还有其它更多尚未测试...

配置(app/config.py)

把Config的host修改为本机地址

运行服务器

源码运行

# linux系统请注意, 需要安装libpng12(centos已测试, 其它系统还没测试), MacOSX系统不需要
`yum install libpng12` # centos

git clone https://github.com/skytoup/AppServer
cd AppServer
gcc vendors/pngdefry/pngdefry.c -o pngdefry # 编译pngdfry
pip install -r requirements.txt # 安装依赖
python main.py # 运行服务器
open https://your_bing_host:8000 # or 打开浏览器, 输入https://{Config的host}:8000, 回车

Docker运行

git clone https://github.com/skytoup/AppServer
cd AppServer
修改app/config/config.py:BaseConfig.host为需要绑定的ip地址, 设置错误会导致iOS无法在线下载安装ipa
docker build -t app_server ./
docker run -d -p 8000:8000 -v /path/to/data:/www/AppServer/data -v /path/to/log:/www/AppServer/log --name AppServer app_server # or docker run -d -p 8000:8000 --name AppServer app_server
open https://your_bing_host:8000 # or 打开浏览器, 输入https://{Config的host}:8000, 回车

服务器的单元测试

pip install -r requirements_test.txt
pytest -q tests

HTML前端

不是专业前端, 只是简单做了一个非常简陋的, 请勿介意😅

详情请看 👉 传送门: AppServerHTML

https证书

证书使用的是自签证书, 每次修改Config的host后, 会自动重新生成

Tip

开启服务器后, 需要在地址栏输入的是Config的host, 不能填写127.0.0.1、localhost、0.0.0.0; 还有协议是https, 不是http
iPhone安装ipa需要在App详情的界面里面点击安装证书, 因为证书是自己生成的, 不能免证书安装(iOS9以上系统安装完证书后, 还需要在设置那里信任一下证书, 请参考: 苹果iOS9系统安装应用证书信任操作指导)
centos和ubuntu安装可能出现的问题 👉 传送门
linux运行aapt需要安装libpng12, centos: yum install libpng12

更详细请看 👉 FAQ

API

基本格式

{
    code: int,  # 请参考👇的表
    ok: bool,  # 是否请求成功
    msg: str,  # 请求返回的信息
    datas: dict/array,  # 请求返回的数据
}

code	描述
0	成功
-1	失败

上传App安装包

POST /upload/app

Form

参数	必填	描述
pcakage	y	上传的安装包
msg	n	更新说明

返回datas: object or not(上传不存在的App时, 才有返回)

参数	描述
id	App的id
type	安装包类型, 0: iOS, 1: Android
name	名称
icon	图标
detail	介绍
short_chain	短链接
package_name	包名
create_at	创建时间

获取App列表

GET /apps/<app_type>/page/<page>?t=<time>

参数	必填	描述
app_type	y	安装包的类型: iOS、android、all
page	y	页码, 从1开始
time	y	当获取第一页时, 为当前时间戳; 获取其它页时, 为获取第一页的时间戳
kw	n	按照App名称过滤

返回datas: array

参数	描述
id	App的id
type	安装包类型, 0: iOS, 1: Android
name	名称
icon	图标
detail	介绍
short_chain	短链接
package_name	包名
version_name	最后上传安装包的版本名称
version_code	最后上传安装包的版本号
create_at	创建时间

获取App详情

GET /apps/<app_id>

参数	必填	描述
app_id	y	App的id

返回datas: dict

参数	描述
id	App的id
type	安装包类型, 0: iOS, 1: Android
name	名称
icon	图标
detail	介绍
short_chain	短链接
package_name	包名
create_at	创建时间

删除整个App(文件也删除)

DELETE /apps/<app_id>

参数	必填	描述
app_id	y	App的id

返回datas: 无

参数	描述

修改App信息

PUT /apps/<app_id>

Json

参数	必填	描述
app_id	y	App的id
-	-	-
name	n	名称
short_chain	n	短链
detail	n	简介

返回datas: 无

参数	描述

获取App的版本列表

GET /apps/<app_id>/versions/page/<page>?t=<time>

参数	必填	描述
app_id	y	App的id
page	y	页码, 从1开始
time	y	当获取第一页时, 为当前时间戳; 获取其它页时, 为获取第一页的时间戳

返回的datas: array

参数	描述
id	App Version的id
app_id	App的id
version_name	版本名
version_code	版本号
package	安装包下载地址
size	安装包大小
update_msg	更新信息
create_at	创建时间
plist	plist下载地址, App类型为iOS时, 才有此字段

删除App的某个版本

DELETE /apps/<app_id>/versions/<app_version_id>

参数	必填	描述
app_id	y	App的id
app_version_id	y	App Version的id

返回datas: 无

参数	描述

版本更新 👉 传送门

使用的开源项目

Sanic: Async Python 3.5+ web server that's written to go fast
shortuuid: A generator library for concise, unambiguous and URL-safe UUIDs. http://www.stavros.io/
sqlalchemy: See the development link for contribution guidelines http://sqlalchemy.org/develop.html
aiofiles: File support for asyncio
pngdefry: Repairing -iPhone fried PNGs

AppServer

简介

功能

使用

环境

配置(app/config.py)

运行服务器

源码运行

Docker运行

服务器的单元测试

HTML前端

https证书

Tip

API

基本格式

上传App安装包

获取App列表

获取App详情

删除整个App(文件也删除)

修改App信息

获取App的版本列表

删除App的某个版本

版本更新 👉 传送门

使用的开源项目

相关文章

讨论&贡献

联系方式

捐献(请喝杯咖啡, 我是不会拒绝的😄)

支付宝

微信