Compare commits

..

13 Commits

Author SHA1 Message Date
xboard
686f8a93ca update dockerfile
Some checks are pending
Docker Build and Publish / build (push) Waiting to run
2025-01-16 14:05:40 +08:00
xboard
3b065903c2 Revert "feat(database): make email field case-insensitive"
This reverts commit 11de1be7b3.
2025-01-16 13:53:47 +08:00
Xboard
5efadf87b0
Update 1panel.md 2025-01-16 13:22:36 +08:00
Xboard
8fd0db170c
Merge pull request #320 from rebecca554owen/patch-1
fix
2025-01-16 13:16:26 +08:00
Xboard
c9b7d89e4b
Merge branch 'master' into patch-1 2025-01-16 13:16:14 +08:00
xboard
90ed8847e9 update docs 2025-01-16 11:49:15 +08:00
xboard
11de1be7b3 feat(database): make email field case-insensitive 2025-01-16 11:43:12 +08:00
xboard
f1654a7ef7 feat: remove email format validation for admin login 2025-01-16 10:55:13 +08:00
xboard
8984edac81 update docs 2025-01-16 10:47:26 +08:00
xboard
871514dd4c update XboardInstall.php 2025-01-16 10:26:21 +08:00
Xboard
cf37376b65
Update 1panel.md 2025-01-16 10:09:54 +08:00
Xboard
746cf3068d
Update 1panel.md 2025-01-16 10:09:22 +08:00
rebecca554owen
1f7af1debf
fix
1panel-network 是一个已经存在的 Docker 网络,Docker Compose 会使用这个网络来连接服务,而不是创建一个新的网络。
2025-01-16 10:03:00 +08:00
9 changed files with 109 additions and 37 deletions

View File

@ -21,5 +21,5 @@ RUN composer install --optimize-autoloader --no-cache --no-dev \
ENV ENABLE_WEB=true \ ENV ENABLE_WEB=true \
ENABLE_HORIZON=true \ ENABLE_HORIZON=true \
ENABLE_REDIS=true ENABLE_REDIS=false
CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"] CMD ["/usr/bin/supervisord", "-c", "/etc/supervisor/conf.d/supervisord.conf"]

View File

@ -39,7 +39,10 @@ docker compose up -d
> After installation, visit: http://SERVER_IP:7001 > After installation, visit: http://SERVER_IP:7001
> ⚠️ Make sure to save the admin credentials shown during installation > ⚠️ Make sure to save the admin credentials shown during installation
## 📚 Documentation ## <20><> Documentation
### 🔄 Upgrade Notice
> 🚨 **Important:** This version involves significant changes. Please strictly follow the upgrade documentation and backup your database before upgrading. Note that upgrading and migration are different processes, do not confuse them.
### Deployment Guides ### Deployment Guides
- [Deploy with 1Panel](./docs/zh-CN/installation/1panel.md) - [Deploy with 1Panel](./docs/zh-CN/installation/1panel.md)

View File

@ -41,6 +41,9 @@ docker compose up -d
## 📚 使用文档 ## 📚 使用文档
### 🔄 升级提示
> 🚨 **重要:** 此次版本跨度较大,请严格按照升级文档进行升级,必要时请备份数据库再进行升级。升级跟迁移不是一个东西,请不要混淆。
### 部署教程 ### 部署教程
- [使用 1Panel 部署](./docs/zh-CN/installation/1panel.md) - [使用 1Panel 部署](./docs/zh-CN/installation/1panel.md)
- [Docker Compose 部署](./docs/zh-CN/installation/docker-compose.md) - [Docker Compose 部署](./docs/zh-CN/installation/docker-compose.md)

View File

@ -175,6 +175,7 @@ class XboardInstall extends Command
// 连接失败,输出错误消息 // 连接失败,输出错误消息
$this->error("redis连接失败" . $e->getMessage()); $this->error("redis连接失败" . $e->getMessage());
$this->info("请重新输入REDIS配置"); $this->info("请重新输入REDIS配置");
$enableRedis = false;
sleep(1); sleep(1);
} }
} }

View File

@ -114,7 +114,7 @@ services:
networks: networks:
1panel-network: 1panel-network:
driver: bridge external: true
``` ```
5. Initialize Installation: 5. Initialize Installation:
@ -151,14 +151,23 @@ docker compose up -d
## 4. Version Update ## 4. Version Update
> 💡 Important Note: The update command varies depending on your installation version:
> - If you installed recently (new version), use this command:
```bash ```bash
docker compose pull && \ docker compose pull && \
docker compose run -it --rm web php artisan xboard:update && \ docker compose run -it --rm web php artisan xboard:update && \
docker compose up -d docker compose up -d
``` ```
> - If you installed earlier (old version), replace `web` with `xboard`:
```bash
docker compose pull && \
docker compose run -it --rm xboard php artisan xboard:update && \
docker compose up -d
```
> 🤔 Not sure which to use? Try the new version command first, if it fails, use the old version command.
## Important Notes ## Important Notes
- ⚠️ Ensure firewall is enabled to prevent port 7001 exposure to public - ⚠️ Ensure firewall is enabled to prevent port 7001 exposure to public
- Service restart is required after code modifications - Service restart is required after code modifications
- SSL certificate configuration is recommended for secure access - SSL certificate configuration is recommended for secure access

View File

@ -138,7 +138,8 @@ services:
networks: networks:
1panel-network: 1panel-network:
driver: bridge external: true
``` ```
#### 4.3 初始化安装 #### 4.3 初始化安装
@ -171,11 +172,21 @@ docker compose up -d
## 维护指南 ## 维护指南
### 版本更新 ### 版本更新
> 💡 重要提示:根据您安装的版本不同,更新命令可能略有差异:
> - 如果您是最近安装的新版本,使用下面的命令:
```bash ```bash
docker compose pull && \ docker compose pull && \
docker compose run -it --rm web php artisan xboard:update && \ docker compose run -it --rm web php artisan xboard:update && \
docker compose up -d docker compose up -d
``` ```
> - 如果您是较早安装的旧版本,需要将命令中的 `web` 改为 `xboard`,即:
```bash
docker compose pull && \
docker compose run -it --rm xboard php artisan xboard:update && \
docker compose up -d
```
> 🤔 不确定用哪个?可以先尝试使用新版命令,如果报错再使用旧版命令。
### 日常维护 ### 日常维护
- 定期检查日志: `docker compose logs` - 定期检查日志: `docker compose logs`

View File

@ -1,10 +1,37 @@
## aaPanel + Docker 快速部署指南 # Xboard 在 aaPanel + Docker 环境下的部署指南
本指南介绍如何使用 aaPanel + Docker Compose 部署 Xboard。 ## 目录
1. [环境要求](#环境要求)
2. [快速部署](#快速部署)
3. [详细配置](#详细配置)
4. [维护指南](#维护指南)
5. [故障排查](#故障排查)
### 1. 环境准备 ## 环境要求
1. 安装 Docker ### 硬件配置
- CPU: 1核心及以上
- 内存: 2GB及以上
- 硬盘: 10GB及以上可用空间
### 软件要求
- 操作系统: Ubuntu 20.04+ / CentOS 7+ / Debian 10+
- aaPanel 最新版
- Docker 和 Docker Compose
- Nginx任意版本
- MySQL 5.7+
## 快速部署
### 1. 安装 aaPanel
```bash
curl -sSL https://www.aapanel.com/script/install_6.0_en.sh -o install_6.0_en.sh && \
bash install_6.0_en.sh aapanel
```
### 2. 基础环境配置
#### 2.1 安装 Docker
```bash ```bash
# 安装 Docker # 安装 Docker
curl -sSL https://get.docker.com | bash curl -sSL https://get.docker.com | bash
@ -14,28 +41,22 @@ systemctl enable docker
systemctl start docker systemctl start docker
``` ```
2. 安装 aaPanel #### 2.2 安装必要组件
```bash 在 aaPanel 面板中安装:
curl -sSL https://www.aapanel.com/script/install_6.0_en.sh -o install_6.0_en.sh && \
bash install_6.0_en.sh aapanel
```
### 2. 环境配置
在 aaPanel 中安装 LNMP
- Nginx任意版本 - Nginx任意版本
- MySQL 5.7 - MySQL 5.7
- ⚠️ 无需安装 PHP 和 Redis - ⚠️ 无需安装 PHP 和 Redis
### 3. 部署步骤 ### 3. 站点配置
1. 添加站点: #### 3.1 创建站点
- 进入 aaPanel > Website > Add site 1. 导航至aaPanel > Website > Add site
- 域名:填写你的域名 2. 填写信息:
- 域名:填写您的站点域名
- 数据库:选择 MySQL - 数据库:选择 MySQL
- PHP 版本:选择纯静态 - PHP 版本:选择纯静态
2. 安装 Xboard #### 3.2 部署 Xboard
```bash ```bash
# 进入站点目录 # 进入站点目录
cd /www/wwwroot/你的域名 cd /www/wwwroot/你的域名
@ -53,16 +74,17 @@ cp compose.sample.yaml compose.yaml
# 安装依赖并初始化 # 安装依赖并初始化
docker compose run -it --rm web sh init.sh docker compose run -it --rm web sh init.sh
``` ```
> 安装完成后请保存返回的后台地址和管理员账号密码 > ⚠️ 请妥善保存安装完成后返回的后台地址和管理员账号密码
3. 启动服务 #### 3.3 启动服务
```bash ```bash
docker compose up -d docker compose up -d
``` ```
4. 配置反向代理: #### 3.4 配置反向代理
在站点配置中添加以下内容:
```nginx ```nginx
location ^~ / { location / {
proxy_pass http://127.0.0.1:7001; proxy_pass http://127.0.0.1:7001;
proxy_http_version 1.1; proxy_http_version 1.1;
proxy_set_header Connection ""; proxy_set_header Connection "";
@ -79,14 +101,28 @@ location ^~ / {
} }
``` ```
### 4. 版本更新 ## 维护指南
### 版本更新
> 💡 重要提示:根据您安装的版本不同,更新命令可能略有差异:
> - 如果您是最近安装的新版本,使用下面的命令:
```bash ```bash
docker compose pull && docker compose run -it --rm web php artisan xboard:update && docker compose up -d docker compose pull && \
docker compose run -it --rm web php artisan xboard:update && \
docker compose up -d
``` ```
> - 如果您是较早安装的旧版本,需要将命令中的 `web` 改为 `xboard`,即:
```bash
docker compose pull && \
docker compose run -it --rm xboard php artisan xboard:update && \
docker compose up -d
```
> 🤔 不确定用哪个?可以先尝试使用新版命令,如果报错再使用旧版命令。
### 注意事项 ### 日常维护
- 定期检查日志: `docker compose logs`
- 监控系统资源使用情况
- 定期备份数据库和配置文件
- ⚠️ 请确保防火墙已开启,避免 7001 端口暴露到公网 ## 故障排查
- 代码修改后需要重启服务才能生效
- 建议配置 SSL 证书以确保安全访问

View File

@ -48,13 +48,22 @@ docker compose up -d
### 3. 版本更新 ### 3. 版本更新
> 💡 重要提示:根据您安装的版本不同,更新命令可能略有差异:
> - 如果您是最近安装的新版本,使用下面的命令:
```bash ```bash
cd Xboard cd Xboard
docker compose pull docker compose pull && \
docker compose down docker compose run -it --rm web php artisan xboard:update && \
docker compose run -it --rm web php artisan xboard:update
docker compose up -d docker compose up -d
``` ```
> - 如果您是较早安装的旧版本,需要将命令中的 `web` 改为 `xboard`,即:
```bash
cd Xboard
docker compose pull && \
docker compose run -it --rm xboard php artisan xboard:update && \
docker compose up -d
```
> 🤔 不确定用哪个?可以先尝试使用新版命令,如果报错再使用旧版命令。
### 4. 版本回滚 ### 4. 版本回滚

File diff suppressed because one or more lines are too long