Docker部署

Docker镜像内已包含所有所需功能，请保存好APP_TOKEN作用为身份验证，一个APP_TOKEN只能同时连接一台设备

最低硬件要求

CPU：1 核心

内存：1 GB (推荐 2 GB)

🐳 Docker一键部署命令

基础版APP_TOKEN已自动生成放到命令中

docker run -e APP_TOKEN=获取中... -v ~/.applo:/app/data -p 8080:80 -p 3000:3000 --name applo --restart unless-stopped -d zzggxx/applo-server:latest

运行前请确保已安装Docker，未安装请运行安装命令

Linux安装Docker命令：

bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --source-registry "https://docker.1panel.live" --install-latest true --ignore-backup-tips

Macos或Windows请自行搜索安装教程

参数说明

参数	说明
-e APP_TOKEN={token}	设置环境变量 APP_TOKEN，用于服务端身份验证。
-v ~/.applo:/app/data	将宿主机的 ~/.applo 目录挂载到容器内的 /app/data，用于持久化保存配置和数据。
-p 8080:80	将宿主机的 8080 端口映射到容器的 80 端口，供 Web 管理界面访问使用。
-p 3000:3000	[可选]将宿主机的 3000 端口映射到容器的 3000 端口，供后端 API 服务访问使用。
--name applo	指定容器名称为 applo，方便后续管理（如停止、重启容器）。
--restart unless-stopped	容器重启策略，设置为 unless-stopped 表示容器在退出时自动重启，除非手动停止容器。
-d zzggxx/applo-server:latest	使用名为 zzggxx/applo-server 的镜像，latest 表示使用最新版本。

🎉 部署成功

• 默认账号：admin@applo.cc
• 默认密码：applo

如果在本机部署可以通过 http://127.0.0.1:8080 访问Applo管理页面。

公网部署

云服务器通过域名访问

方式一：宝塔

添加站点后配置反向代理到8080端口，配置即可通过域名进行访问

方法一

方法二

站点nginx配置文件添加以下配置

location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

方式二：Nginx

在你的 Nginx 配置文件的 server 块中添加如下反向代理配置，将域名流量转发到 Docker 容器的 8080 端口：

Nginx 配置

server {
    listen 80;
    server_name <域名>;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

将 <域名> 替换为你的实际域名。配置完成后，重载 Nginx：

sudo nginx -s reload

注意事项

• 请确保8080端口未被占用，否则需要修改映射端口。
• 域名需要解析到服务器上

后端API地址

本项目为前后端分离结构，前端提供页面渲染，通过后端API接口获取数据。

后端地址为： 前端地址 + /api/

http://<前端地址>/api/

如体验站点：http://182.140.180.90:58264/api/

数据备份与恢复

数据存放在宿主机的用户目录~/.applo中，其中applo.sqlite为数据库文件，logs为日志目录，tmp为分享模版上传的图片资源

无特殊情况直接备份.applo目录即可

建议定期到后台页面备份一下数据库

更新版本无需备份

更多玩法

• NAS
• 内网穿透
• 挂机宝