初步完成宝塔面板部署文档

hefengbao · Nov 25, 2024 · ca6209e · ca6209e
1 parent 03e92a8
commit ca6209e
Show file tree

Hide file tree

Showing 19 changed files with 195 additions and 11 deletions.
diff --git a/docs/guide/bt-deploy.md b/docs/guide/bt-deploy.md
@@ -24,16 +24,12 @@
 
 ![](../images/bt18.png)
 
-域名那里有域名填写域名，没有的话填写公网 IP。
 
-根目录选择到 `public` 目录：
-
-![](../images/bt19.png)
-
-数据库选择 MySql, 用户名、账号填写上一步创建的。
+一些设置：
 
+设置运行目录：
 
-一些设置：
+![](../images/bt19.png)
 
 
 ![](../images/bt21.png)
@@ -68,9 +64,156 @@ location ~ \.php$ {
 ![](../images/bt22.png)
 
 
-
 一点修改：
 
-![](../images/bt24.png)
+复制 `.env.example` 文件，修改名称为 `.env`，编辑 `.env` 文件：
+
 
 ![](../images/bt25.png)
+
+
+修改权限：
+
+![](../images/bt24.png)
+
+
+需要修改的内容：
+
+```
+APP_NAME=玉竹 #修改为自己的博客名称，若中间有空格、标点符号，请用英文引号（""）包裹
+APP_ENV=production
+
+
+APP_URL=http://127.0.0.1 # 修改为自己的域名或公网IP
+ASSET_URL=http://127.0.0.1 # 修改为自己的域名或公网IP
+
+
+MAIL_MAILER=smtp
+MAIL_HOST=mailhog 
+MAIL_PORT=1025
+MAIL_USERNAME=null
+MAIL_PASSWORD=null
+MAIL_ENCRYPTION=null
+MAIL_FROM_ADDRESS="hello@example.com"
+
+SESSION_DRIVER=redis
+
+QUEUE_CONNECTION=redis
+
+CACHE_STORE=redis
+
+```
+
+邮箱配置参考 [使用 QQ 邮箱作为邮箱服务](deploy#使用-qq-邮箱作为邮箱服务)。
+
+登入终端，运行命令：
+
+
+![](../images/bt26.png)
+
+
+```shell
+cd /www/wwwroot/yuzhu-v1.0.0 # 修改为实际的目录
+```
+
+```shell
+php artisan key:generate
+```
+
+遇到权限问题，可使用 `sudo php artisan key:generate` 命令。
+
+创建软软连接：
+
+```shell
+php artisan storage:link
+```
+
+
+初始化数据库：
+
+```shell
+php artisan migrate --seed
+```
+
+![](../images/bt30.png)
+
+
+初始化管理员：
+
+```shell
+php artisan yuzhu:init-admin
+```
+
+![](../images/bt31.png)
+
+
+删除安装过程中因报错等生成的 Log 文件，以避免出现权限问题。
+
+![](../images/bt33.png)
+
+
+
+访问：
+
+![](../images/bt32.png)
+
+
+管理后台在域名后添加 `/admin` 访问即可。
+
+
+以下操作在终端完成：
+
+安装 `supervisor`:
+
+```shell
+sudo apt install supervisor
+```
+
+```shell
+sudo vi /etc/supervisor/conf.d/yuzhu-horizon.conf
+```
+
+复制如下内容，注意修改为自己的目录，
+
+```
+[program:yuzhu-horizon]
+process_name=%(program_name)s
+command=php /www/wwwroot/yuzhu-v1.0.0/artisan horizon
+autostart=true
+autorestart=true
+user=www
+redirect_stderr=true
+stdout_logfile=/www/wwwroot/yuzhu-v1.0.0/storage/logs/horizon.log
+stopwaitsecs=3600
+```
+
+鼠标右键粘贴，然后输入 `:wq` 保存。
+
+
+```shell
+sudo supervisorctl reread
+
+sudo supervisorctl update
+
+sudo supervisorctl start yuzhu-horizon:*
+```
+
+一些优化：
+
+```shell
+php artisan route:cache
+php artisan view:cache
+php artisan config:cache
+```
+
+
+设置定时任务：
+
+![](../images/bt40.png)
+
+```
+cd /www/wwwroot/yuzhu-v1.0.0 && php artisan schedule:run
+```
+
+注意设为自己实际的目录
+
diff --git a/docs/guide/bt-env.md b/docs/guide/bt-env.md
@@ -19,6 +19,11 @@
 需要安装的扩展参考 [https://laravel.com/docs/11.x/deployment#server-requirements](https://laravel.com/docs/11.x/deployment#server-requirements)
 
 
+删除被禁用的函数：`proc_open `，`symlink`,`pcntl_*` 相关的函数
+
+![](../images/bt29.png)
+
+
 ## 服务器软件选择 `Nginx`:
 
 

diff --git a/docs/guide/deploy.md b/docs/guide/deploy.md
@@ -76,11 +76,48 @@ MAIL_PASSWORD=null
 MAIL_ENCRYPTION=null
 MAIL_FROM_ADDRESS="hello@example.com"
 
+
+SESSION_DRIVER=redis
+
+QUEUE_CONNECTION=redis
+
+CACHE_STORE=redis
+
+```
+
+### 使用 QQ 邮箱作为邮箱服务
+
+如果没有其他邮箱服务，可以使用 QQ 邮箱，登录 QQ 邮箱，选择 【设置】 - 【账号】，【POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务】 ：
+
+![](../images/bt35.png)
+
+![](../images/bt36.png)
+
+如果已开启，在点击 【管理服务】 - 【生成授权码】：
+
+![](../images/bt37.png)
+
+
+示例配置：
+
+```
+MAIL_MAILER=smtp
+MAIL_HOST=smtp.qq.com 
+MAIL_PORT=465
+MAIL_USERNAME="10000@qq.com"
+MAIL_PASSWORD=授权码
+MAIL_ENCRYPTION=ssl
+MAIL_FROM_ADDRESS="10000@qq.com"
 ```
 
+
+
 验证邮箱是否配置成功：
+
 ```shell
 php artisan yuzhu:check-email
+
+php artisan queue:work --queue=high,default
 ```
 
 ## 生成数据表及数据填充:

diff --git a/docs/guide/faq.md b/docs/guide/faq.md
@@ -12,5 +12,4 @@
 
 ```shell
 php artisan vendor:publish --force --tag=livewire:assets
-```
-这个问题是别人遇到的，解决办法也是别人说的，未曾验证。
+```
diff --git a/docs/images/bt18.png b/docs/images/bt18.png
diff --git a/docs/images/bt19.png b/docs/images/bt19.png
diff --git a/docs/images/bt23.png b/docs/images/bt23.png
diff --git a/docs/images/bt24.png b/docs/images/bt24.png
diff --git a/docs/images/bt25.png b/docs/images/bt25.png
diff --git a/docs/images/bt26.png b/docs/images/bt26.png
diff --git a/docs/images/bt29.png b/docs/images/bt29.png
diff --git a/docs/images/bt30.png b/docs/images/bt30.png
diff --git a/docs/images/bt31.png b/docs/images/bt31.png
diff --git a/docs/images/bt32.png b/docs/images/bt32.png
diff --git a/docs/images/bt33.png b/docs/images/bt33.png
diff --git a/docs/images/bt35.png b/docs/images/bt35.png
diff --git a/docs/images/bt36.png b/docs/images/bt36.png
diff --git a/docs/images/bt37.png b/docs/images/bt37.png
diff --git a/docs/images/bt40.png b/docs/images/bt40.png