安装
本项目依托容器技术需要安装相关容器服务才可以部署,由于运行环境复杂程度较高目前没有计划适配更多部署方式
如果你不了解该项技术或者没有安装相关服务那么请先阅读 如何安装容器服务
1. 启动容器
- CLI - 命令行
- Compose - 编排
docker run -dit \
--name arcadia \
--hostname arcadia \
--network bridge \
--restart always \
-p 5678:5678 \
-v /opt/arcadia/config:/arcadia/config \
-v /opt/arcadia/log:/arcadia/log \
-v /opt/arcadia/scripts:/arcadia/scripts \
-v /opt/arcadia/repo:/arcadia/repo \
-v /opt/arcadia/raw:/arcadia/raw \
-v /opt/arcadia/tgbot:/arcadia/tgbot \
supermanito/arcadia:beta
新建 YAML 文件
编辑内容
启动容器
mkdir -p /opt/arcadia && cd /opt/arcadia
vim docker-compose.yaml
services:
arcadia:
image: supermanito/arcadia:beta
container_name: arcadia
hostname: arcadia
restart: always
tty: true
network_mode: bridge
ports:
- 5678:5678
volumes:
- /opt/arcadia/config:/arcadia/config
- /opt/arcadia/log:/arcadia/log
- /opt/arcadia/scripts:/arcadia/scripts
- /opt/arcadia/repo:/arcadia/repo
- /opt/arcadia/raw:/arcadia/raw
- /opt/arcadia/tgbot:/arcadia/tgbot
docker compose up -d
命令帮助
- 点击右侧的齿轮图标可以自定义命令参数配置
- 提示
-bash: docker:Command not found/未找到命令
? 请先阅读 如何安装容器服务 - 如果你正在使用旁路由则可能需要将网卡工作切换为 host 类型(桥接),找到
network
字样更改右边的值即可 - 不可以更改参数中
:
右边的内容,否则会导致后端服务无 法正常访问
挂载目录的作用是什么?
容器挂载目录的作用是将宿主机的文件系统目录或文件挂载到容器内。这样,容器内的程序可以像访问本地文件一样访问挂载的文件或目录,同时宿主机上的应用也可以直接访问这些文件或目录。这种机制提供了一种在容器和宿主机之间共享文件的方式,使得数据持久化成为可能,因为即使容器被删除,挂载的数据仍然存在于宿主机上,便于用户迁移数据。
关于 Arcadia 平台的占用空间
目前底层镜像基于 Debian 进行构建,这导致 Arcadia 平台镜像的占用空间大小达到了 1.01GB,在不更换底层构建镜像的前提下已经最大化压缩了镜像大小,考虑到实际使用环境的生态多样性因此这是取舍利弊后的决策选择,实际上在使用期间会安装很多依赖内容,届时镜像大小的差异与容器总体占用空间的差异相比就显得不再那么重要了,你应该预留出 2GB
的空间以供使用。
2. 检查启动状态
docker logs -f arcadia
请认真查看容器启动后的初始化进度并等待其运行完毕,当输出容器启动成功字样后即可通过 Ctrl + C
退出查看
如果报错导致容器没有启动成功那么请先自查原因,绝大多数问题都是由网络环境导致,你可以在 社区 内寻求帮助
3. 开始使用
访问 http://localhost:5678 进入管理面板,初始用户名和密码分别是 useradmin
passwd
,首次登录后会引导你修改此认证信息
无法访问?我们提供了一份 排除故障指南,希望对你有所帮助
除管理面板外,项目支持强大的命令行指令,具体请翻阅 CLI 文档,有关用户配置的问题详见文档相关介绍和配置文件中的注释
提高网络安全防范意识,尽量不要将你的面板完全暴露在公网,不要运行来历不明的代码,尽量不要下载任何有风险的内容
如果你需要在公网使用,请提高面板登录密码的强度并留意上次登录信息,虽然平台设计了一些防护措施但这并不是万能的
特别声明:若遭遇不法分子入侵作者对于由此引起的任何后果概不负责,你应该注重存储数据内容的安全防护以及潜在的隐私泄露问题
如果你需要在公网使用,请提高面板登录密码的强度并留意上次登录信息,虽然平台设计了一些防护措施但这并不是万能的
特别声明:若遭遇不法分子入侵作者对于由此引起的任何后果概不负责,你应该注重存储数据内容的安全防护以及潜在的隐私泄露问题
了解文件目录结构
/arcadia
├── config 配置文件目录(用户)
├── log 日志存放目录(用户)
├── repo 代码仓库存放目录(用户)
├── raw 代码仓库目录(用户)
├── scripts 个人文件存放目录(用户)
├── tgbot TG机器人组件存放目录(用户)
└── src 项目源代码目录