服务端体验版部署指南 - Linux #

安装 docker #

请下载对应的 Docker Desktop，安装完成后启动。如已安装，请跳过此步。

Install Docker Engine on Ubuntu

安装 AO.space 服务端 #

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

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  \
hub.eulix.xyz/cicada-private/aospace-agent:latest

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

使用 #

防火墙 #

请在电脑端防火墙允许访问 tcp 5678、12841 和 18569 端口，udp 61001至62000 端口范围的网络访问权限。也可以关闭防火墙做测试。

上述 5678 端口一般用于局域网内绑定、解绑等接口调用。如果您是在云服务器上部署并在公网下使用，在手机APP绑定之后可在云主机厂商的防火墙设置中关闭 5678 端口外部访问。12841 和 18569 端口用于局域网中手机 APP 直连 AO.space 服务器，如果是部署在云服务器上也建议在云主机厂商的防火墙设置中关闭，不影响正常使用。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 地址。在打开的网页中输入您申请的邮箱，以及邮件中的激活码，点击【提交】。如果此时 AO.space docker 容器镜像尚未完全下载完成，会提示正在下载中，网页不需要关闭，等容器安装完成后再点击【提交】按钮。

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

注意事项 #

• 注意安装目录 aospace 所在的磁盘剩余空间要大于 5G，否则绑定成功后上传文件会报空间不足。
• 绑定设备时，需保证电脑和手机在同一个局域网内，绑定成功后开始使用无需在同一局域网内。
• 激活码有效期24小时，失效后请重新获取。
• 一个邮箱只能激活一台 PC 设备，如想更多设备使用请更换邮箱重新申请。

更新 #

方式一 App 内升级 #

App 客户端【我的】-【设备】-【系统升级】 可以选择自动升级或手动升级

方式二 命令行升级 #

删除 aospace-all-in-one #

依次在宿主机的命令行中执行以下步骤：

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 #

执行本文 安装 AO.space 服务端 一节的安装命令，但是 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  \
hub.eulix.xyz/cicada-private/aospace-agent:latest

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

卸载 #

请在宿主机的命令行中执行以下命令:

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

在宿主机上删除安装 AO.space 服务端 一节指定的数据目录。

至此卸载完成。

清理 #

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

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

其他环境安装 #

群晖 #

操作步骤 #

群晖 DSM 就是一个 Linux 系统，所以安装步骤总体参考服务端体验版部署 Linux 指南

1. 请先 ssh 登录群晖，因为群晖管理页面部署容器有限制，无法完成 AO.space 的部署。

2. 安装准备

确定 aospace 安装目录的位置，这里以 /volume1/homes/username/aospace 为例。

因群晖权限问题无法自动创建目录，需用户手动创建目录

在 File Station 中 homes/username/ 下创建 aospace 目录。

右键，新建目录 aospace - 属性 - 权限 - Create 。

在新弹出窗口中 User or group 选择 Docker， Type 选择 Allow， Apply To 为 ALL, Permission 中全选。然后点 Done。

保存权限。

3. 执行安装命令

sudo docker network create bp-cicada
DATADIR="/volume1/homes/username/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

申请激活码 #

请参考申请加入公测章节

绑定设备 #

请参考绑定设备章节

注意事项 #

1. 如果绑定失败，需要检查一下如下目录是否创建，如果没有创建则需要手动创建。

cd /volume1/homes/username/aospace

然后在aospace目录中执行以下命令

sudo mkdir -p home/eulixspace_link/postgresql/data
sudo mkdir -p home/eulixspace_link/redis/data
sudo mkdir -p backup
sudo mkdir -p opt/eulixspace/image
sudo mkdir -p etc/bp/meta/shared
sudo mkdir -p home/eulixspace_file_storage/parts/bp_part_dummy/dav/cards/collections/collection-root/root
sudo mkdir -p opt/eulix
sudo mkdir -p home/eulixspace_file_storage/parts/bp_part_dummy/eulixspace-files
sudo mkdir -p opt/logs/gateway
sudo mkdir -p opt/eulixspace/applet
sudo mkdir -p etc/bp/meta/admin
sudo mkdir -p opt/eulixspace-web/space/applet/
sudo mkdir -p home/eulixspace_link/nginx/conf.d
sudo mkdir -p etc/bp/certs
sudo mkdir -p home/eulixspace_file_storage/parts/bp_part_dummy/third_party
sudo mkdir -p opt/logs/filepreview

2. 请求无法访问到个别服务

• 原因：部分服务与原有部署的服务端口冲突
• 解决方法：修改各处服务端口保证统一

查看 aospace-nginx 容器 /etc/openresty/nginx.conf 文件 查看 proxy_pass 对应端口和容器实际运行端口一直

• 修改服务为默认端口
  • aospace-gateway 对应默认端口 8080
  • aospace-fileapi 对应默认端口 2001
  • aospace-container-mgr 对应默认端口 2878
  • aospace-redis 对应默认端口 6379

3. 如果绑定失败，在群晖上执行 top 命令，查看 cpu 的 wait，如果 wait 很高（可能会到90%左右），说明当前可用 cpu 很少，所以绑定过程会非常的卡，很容易失败。请耐心多尝试几次。而且如果绑定过程中 cpu 的 wait 很高的话，绑定完成后，要等 wait 降低后，再来操作 AO.space 。

openwrt #

操作步骤 #

1. 请先 ssh 登录 istore os

2. 执行以下命令

docker network create bp-cicada
DATADIR="/mnt/mmc/aospace"
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

申请激活码 #

请参考加入公测章节

绑定设备 #

请参考绑定设备章节

注意事项 #

1. istore os 系统安装完成后，只使用了 2G+ 的磁盘，剩余磁盘为空闲状态。需要手动分区格式化挂载。

2. 在首页-docker-快速配置中迁移 docker 的路径。因为默认的路径空间太小，安装容器很容易失败。需要迁移到一个比较大的磁盘分区上。

联系我们 #

如果你在使用当中遇到困难，可查看 帮助手册 或者 联系我们 。