1
0
mirror of https://gitee.com/bookshelfplus/bookshelfplus synced 2025-09-21 01:10:39 +08:00
Code Issues Projects Releases Wiki Activity GitHub Gitee

快捷登录;README.md 添加 常见问题FAQ;添加查看node运行进程和杀掉node进程批处理

This commit is contained in:
2022-04-03 16:53:36 +08:00
parent b1483d7bc9
commit a54e96de38
5 changed files with 107 additions and 4 deletions

View File

@@ -106,6 +106,17 @@ npm config set registry https://registry.npm.taobao.org/
### 下载项目
```
# TODO
# 设置文件夹权限 (Linux)
# TODO
```
### 项目配置
```bash
@@ -121,7 +132,7 @@ npm config set registry https://registry.npm.taobao.org/
# [后端]
# 配置 MySQL 数据库地址
# TODO
# 配置 Redis
# 配置 Redis 地址
# TODO
```
@@ -288,9 +299,87 @@ node ./bookshelfplus-frontend/cleanup.js
## 注意事项
## 疑难解答
- nginx启动目录不能包含中文否则无法启动
### 动态压缩字体技术
项目使用了动态压缩字体技术因为中文字体包过大无法快速加载所以在用户访问网页加载完成后使用js取得页面上显示的所有文字然后发回给后端后端返回一个压缩后的字体包。
由于页面上显示的文字相对字体包而言很少所以压缩后的字体基本上只有几十K到几百K这样便于网络传输。
## 常见问题 FAQ
### Nginx 无法启动
【问题原因】
nginx启动目录不能包含中文否则无法启动
【解决方法】
将 nginx 安装到不包含中文和特殊字符的目录中
### 项目启动后,自定义字体加载失败
【问题原因】
因为项目文件夹的权限不够,导致无法生成字体文件,进而导致前端访问不到字体文件。
【解决方法】
修改项目文件夹的权限和用户组,参考命令如下(修改成你自己的配置,不要直接执行)
```bash
# 修改用户组
sudo chown -R www-data:www-data bookshelf.plus/
# www-data:www-data 改成你自己的用户组bookshelf.plus/改成你本项目的文件夹
# 修改权限
chmod -R 755 bookshelf.plus/
```
### 项目启动后,可以看到项目界面,但是无法查询、登录等
【问题原因】
可能是后端服务没有成功启动
【解决方法】
首先点击页脚的“网站状态检测”,看看后台服务器能否正常连接。
如果能够连接,那么就是后端与数据库之间的连接出现了问题。
> 例如数据库没开数据库没有导入SQL文件后端的数据库连接信息配置错误等等
如果不能连接,那么就是后端服务的问题,检查一下后端服务是否已经打开了。
### 云服务器上,项目启动成功,但是无法访问网页
【问题原因】
可能是 nginx 文件配置错误,或者服务器的端口没有对外开放
【解决方法】
检查一下
- 云服务器的“安全组”不同厂商有不同的叫法中是否开放了80端口
- nginx 配置是否正确(主要看 server_name, listen, location 等配置)
### 其他问题
以上仅列出了部分常见问题,如果您没有找到相关解决方法,可以在 GitHub 仓库中创建一个 issue。提问时请注意要尽可能详细地描述问题以及社区提问基本礼仪。

View File

@@ -5,7 +5,7 @@
"scripts": {
"start": "node app",
"dev": "nodemon",
"test": "set NODE_ENV=production & nodemon",
"test": "set NODE_ENV=development & nodemon",
"prod": "set NODE_ENV=production & pm2 start app.js --name bookshelfplus-frontend",
"prod-stop": "pm2 stop bookshelfplus-frontend",
"clean": "node cleanup.js"

View File

@@ -14,6 +14,9 @@
<p class="emphasize">
一个完全免费无门槛的计算机类电子书下载网站
</p>
<p style="color: red;">
项目还在开发中,功能暂时还无法正常使用。
</p>
</div>
</div>
<%- include("./component/footer.html"); %>

View File

@@ -0,0 +1,5 @@
@echo off
taskkill /f /t /im node.exe
pause

View File

@@ -0,0 +1,6 @@
@echo off
tasklist /fi "imagename eq node.exe"
echo.
pause