傲空间私有部署 Linux 指南

推荐阅读

智能化校园：深入探讨云端管理系统设计与实现（一）
智能化校园：深入探讨云端管理系统设计与实现（二）

安装 docker

请下载对应的 Docker，安装完成后启动。
Install Docker Engine on Ubuntu

可以尝试执行语句：sudo docker run hello-world
成功现象：

安装傲空间服务端

以下命令请在宿主机上执行：

sudo docker network create bp-cicada
DATADIR="/mnt/aospace"
sudo docker run -d --name aospace-all-in-one  \
--restart always  \
--network=bp-cicada  \
--publish 5678:5678  \
--publish 127.0.0.1:5680:5680  \
-v $DATADIR:/aospace  \
-v /var/run/docker.sock:/var/run/docker.sock:ro  \
-e AOSPACE_DATADIR=$DATADIR  \
-e RUN_NETWORK_MODE="host"  \
hub.eulix.xyz/cicada-private/aospace-agent:latest

上述设置的环境变量 DATADIR 表示数据存储在 /mnt/aospace 目录，可自行更改。请注意，该数据存储目录需要拥有读写权限。
执行完成后现象：

使用#

防火墙#

请在电脑端防火墙允许访问 tcp 5678、80 和 443 端口，udp 61001至62000 端口范围的网络访问权限。也可以关闭防火墙做测试。
上述 5678 端口一般用于局域网内绑定、解绑等接口调用。如果您是在云服务器上部署并在公网下使用，在手机APP绑定之后可在云主机厂商的防火墙设置中关闭 5678 端口外部访问。80 和 443 端口用于局域网中手机 APP 直连傲空间服务器，如果是部署在云服务器上也建议在云主机厂商的防火墙设置中关闭，不影响正常使用。udp 61001至62000 用于点对点访问(P2P)，对于云服务器部署也可以在防火墙中打开。

申请加入公测#

点击申请加入傲空间公测, 输入自己的邮箱，点击 “提交申请” 。审核通过后会将公测激活码发送到您填写的邮箱，请注意查收。

绑定设备#

请使用电脑的浏览器打开如下网址: http://<电脑的局域网 IP 地址>:5678 。（比如 http://192.168.0.115:5678） , 其中的 192.168.0.115 是当前电脑的局域网 IP 地址，需要替换成您个人电脑的 IP，请勿使用 127.0.0.1 或 localhost 等。如果您是在云服务器上部署并在公网下使用，这里需要输入您云主机的公网 IP 地址。在打开的网页中输入您申请的邮箱，以及邮件中的激活码，点击 “提交”。如果此时傲空间 docker 容器镜像尚未完全下载完成，会提示正在下载中，网页不需要关闭，等容器安装完成后再点击 “提交” 按钮。

公测激活码校验成功后，网页上出现的二维码就是傲空间电脑端设备二维码。需下载安装傲空间 APP 客户端配合使用，可以在 App Store 搜索 “傲空间” 或进入傲空间下载中心扫码下载，打开傲空间 App 在登录页点击 “绑定设备” 按钮，进入绑定设备页面点击 “扫码二维码” 对准电脑上的设备二维码进行扫码绑定，绑定成功后即可开始使用。

注意事项#

绑定设备时，需保证电脑和手机在同一个局域网内，绑定成功后开始使用无需在同一局域网内。
激活码有效期24小时，失效后请重新获取。
一个邮箱只能激活一台 PC 设备，如想更多设备使用请更换邮箱重新申请。

更新#

删除 aospace-all-in-one#

如您的傲空间系统是 2.0.0 及以前的版本，请在更新前务必将开发者模式安装的 docker 容器，在傲空间 APP 我的-设置-开发者选项中依次卸载，否则可能会造成服务更新失败的问题。2.0.1 及以后版本，无需删除开发者模式安装的 docker 容器。
然后依次在宿主机的命令行中执行以下命令:

sudo docker stop aospace-all-in-one
sudo docker rm aospace-all-in-one
sudo docker rmi -f $(docker images -q hub.eulix.xyz/cicada-private/aospace-agent)

更新 aospace-all-in-one#

执行本文安装傲空间服务端一节的安装命令，但是 docker network 不再次创建。依次在宿主机的命令行中执行以下命令:

DATADIR="/mnt/aospace"
sudo docker run -d --name aospace-all-in-one  \
--restart always  \
--network=bp-cicada  \
--publish 5678:5678  \
--publish 127.0.0.1:5680:5680  \
-v $DATADIR:/aospace  \
-v /var/run/docker.sock:/var/run/docker.sock:ro  \
-e AOSPACE_DATADIR=$DATADIR  \
-e RUN_NETWORK_MODE="host"  \
hub.eulix.xyz/cicada-private/aospace-agent:latest

至此更新完成。原数据依然保留在安装时指定的数据目录，无需重新扫码绑定，请放心使用。

卸载

如您的傲空间系统是 2.0.0 及以前的版本，请在更新前务必将开发者模式安装的 docker 容器，在傲空间 APP 我的-设置-开发者选项中依次卸载，否则可能会造成服务更新失败的问题。2.0.1 及以后版本，无需删除开发者模式安装的 docker 容器。
然后请在宿主机的命令行中执行以下命令:

sudo docker exec -t aospace-all-in-one /usr/bin/docker-compose -f /aospace/opt/tmp/docker-compose.yml down
sudo docker stop aospace-all-in-one
sudo docker rm aospace-all-in-one
sudo docker rmi -f $(sudo docker images -q hub.eulix.xyz/cicada-private/*)
sudo docker network rm bp-cicada

在宿主机上删除安装傲空间服务端一节指定的数据目录。
至此卸载完成。

清理#

通过以下命令可以将没有容器使用 Docker镜像和数据卷都删掉。注意，该命令会把你暂时关闭的容器，以及暂时没有用到的 Docker 镜像都删掉了。请慎用!

docker system prune --all --force --volumes