添加 readme.md
parent
7a4232c076
commit
5b0371034b
|
|
@ -0,0 +1,401 @@
|
|||
# UP-Portal 系统部署指南
|
||||
|
||||
## 目录
|
||||
- [项目结构](#项目结构)
|
||||
- [部署步骤](#部署步骤)
|
||||
- [Nginx 部署](#一nginx-部署)
|
||||
- [前端部署](#二前端部署)
|
||||
- [服务器环境](#三服务器环境部署)
|
||||
- [Nacos 部署](#四nacos-部署)
|
||||
- [Minio 部署](#五minio-部署)
|
||||
- [服务端部署](#六服务端部署)
|
||||
- [注意事项](#注意事项)
|
||||
|
||||
---
|
||||
|
||||
## 项目结构
|
||||
```
|
||||
portal_client/ # 网站前端
|
||||
portal_admin/ # 网站管理端
|
||||
portal_server/ # 后端服务
|
||||
nacos_config/ # Nacos 配置文件
|
||||
sql/ # 数据库脚本
|
||||
up-portal/ # 图片资源
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 部署步骤
|
||||
|
||||
### 一、Nginx 部署
|
||||
|
||||
#### 1. 安装依赖
|
||||
```bash
|
||||
apt install -y gcc make libpcre3 libpcre3-dev zlib1g zlib1g-dev openssl libssl-dev
|
||||
```
|
||||
|
||||
#### 2. 编译安装
|
||||
```bash
|
||||
tar -xzvf nginx-x.x.x.tar.gz
|
||||
cd nginx-x.x.x
|
||||
./configure
|
||||
make
|
||||
make install
|
||||
```
|
||||
|
||||
#### 3. 配置系统服务
|
||||
创建文件 `/lib/systemd/system/nginx.service`：
|
||||
```ini
|
||||
[Unit]
|
||||
Description=nginx
|
||||
After=network.target
|
||||
|
||||
[Service]
|
||||
Type=forking
|
||||
ExecStart=/usr/local/nginx/sbin/nginx
|
||||
ExecReload=/usr/local/nginx/sbin/nginx -s reload
|
||||
ExecStop=/usr/local/nginx/sbin/nginx -s stop
|
||||
PrivateTmp=true
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
```
|
||||
|
||||
#### 4. 启动服务
|
||||
```bash
|
||||
systemctl daemon-reload
|
||||
systemctl enable nginx
|
||||
systemctl start nginx
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 二、前端部署
|
||||
|
||||
#### 1. 打包前端
|
||||
```bash
|
||||
npm run build:prod
|
||||
```
|
||||
|
||||
#### 2. Nginx 配置
|
||||
编辑 `/usr/local/nginx/conf/nginx.conf`：
|
||||
```nginx
|
||||
# 客户端（80端口）
|
||||
server {
|
||||
listen 80;
|
||||
server_name localhost;
|
||||
|
||||
location / {
|
||||
root /path/to/up-portal-1.0.1;
|
||||
index index.html;
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
location /portal/ {
|
||||
proxy_pass http://localhost:9080;
|
||||
}
|
||||
|
||||
location /files {
|
||||
proxy_set_header Host $http_host;
|
||||
proxy_pass http://localhost:9000/up-portal;
|
||||
}
|
||||
}
|
||||
|
||||
# 管理端（8080端口）
|
||||
server {
|
||||
listen 8080;
|
||||
server_name localhost;
|
||||
|
||||
location / {
|
||||
root /path/to/up-portal-admin-1.0.1;
|
||||
index index.html;
|
||||
try_files $uri $uri/ /index.html;
|
||||
}
|
||||
|
||||
location /files {
|
||||
proxy_set_header Host $http_host;
|
||||
proxy_pass http://localhost:9000/up-portal;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 三、服务器环境部署
|
||||
|
||||
#### 1. 安装 JDK
|
||||
```bash
|
||||
tar -xzvf jdk-x.x.x_linux-x64_bin.tar.gz -C /opt
|
||||
# 配置环境变量，并使其生效。
|
||||
vim /etc/profile
|
||||
...
|
||||
echo 'export JAVA_HOME=/opt/jdk-x.x.x
|
||||
export PATH=$PATH:$JAVA_HOME/bin' >> /etc/profile
|
||||
source /etc/profile
|
||||
```
|
||||
|
||||
#### 2. 安装 MySQL
|
||||
```bash
|
||||
apt install -y mysql-server
|
||||
|
||||
# 查看mysql内置用户和密码
|
||||
|
||||
cat /etc/mysql/debian.cnf
|
||||
...
|
||||
user = debian-sys-maint
|
||||
password = HzIAVrYXdjwUndPe
|
||||
...
|
||||
|
||||
# 设置root用户的密码 配置远程访问
|
||||
mysql -udebian-sys-maint -p
|
||||
mysql> alter user 'root'@'localhost' identified with mysql_native_password by '123456';
|
||||
mysql> use mysql; # 使用模式mysql
|
||||
mysql> update user set host = '%' where user = 'root';
|
||||
mysql> exit;
|
||||
|
||||
|
||||
# 修改配置文件
|
||||
vim /etc/mysql/mysql.conf.d/mysqld.cnf
|
||||
...
|
||||
# bind-address = 127.0.0.1 # 或将 127.0.0.1 改为 0.0.0.0
|
||||
...
|
||||
# 重新启动服务
|
||||
service mysql restart
|
||||
|
||||
|
||||
#### 3. 安装 Redis
|
||||
```bash
|
||||
#安装Redis
|
||||
apt install -y redis-server
|
||||
|
||||
# 修改配置
|
||||
vim /etc/redis/redis.conf
|
||||
...
|
||||
# bind 127.0.0.1
|
||||
# protected-mode yes
|
||||
requirepass foobared
|
||||
...
|
||||
|
||||
#重新启动redis
|
||||
redis-cli shutdown
|
||||
redis-server /etc/redis/redis.conf
|
||||
|
||||
|
||||
|
||||
```
|
||||
|
||||
#### 4. 安装 RabbitMQ
|
||||
```bash
|
||||
# 使用apt命令安装RabbitMQ，但需要Erlang语言的支持
|
||||
apt install -y erlang-nox
|
||||
apt install -y rabbitmq-server
|
||||
# 默认guest用户不能进行远程登录，添加admin用户，并赋予administrator权限。
|
||||
rabbitmqctl add_user admin admin
|
||||
rabbitmqctl set_user_tags admin administrator
|
||||
rabbitmqctl set_permissions -p / admin '.*' '.*' '.*'
|
||||
# 启动RabbitMQ Web管理工具。
|
||||
cd /etc/rabbitmq
|
||||
rabbitmq-plugins enable rabbitmq_management
|
||||
|
||||
|
||||
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 四、Nacos 部署
|
||||
|
||||
#### 1. 安装配置
|
||||
```bash
|
||||
tar -xzvf nacos-server-x.x.x.tar.gz -C /opt
|
||||
|
||||
#修改配置文件
|
||||
cd /opt/nacos
|
||||
vim bin/startup.sh
|
||||
...
|
||||
# [ ! -e "$JAVA_HOME/bin/java" ] && JAVA_HOME=$HOME/jdk/java
|
||||
# [ ! -e "$JAVA_HOME/bin/java" ] && JAVA_HOME=/usr/java
|
||||
# [ ! -e "$JAVA_HOME/bin/java" ] && JAVA_HOME=/opt/taobao/java
|
||||
# [ ! -e "$JAVA_HOME/bin/java" ] && unset JAVA_HOME
|
||||
JAVA_HOME=/opt/jdk-x.x.x
|
||||
...
|
||||
|
||||
# 配置数据库
|
||||
vim /opt/nacos/conf/application.properties
|
||||
|
||||
```
|
||||
```properties
|
||||
db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?
|
||||
characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true
|
||||
&useUnicode=true&useSSL=false&serverTimezone=UTC
|
||||
db.user.0=nacos
|
||||
db.password.0=nacos
|
||||
|
||||
```
|
||||
|
||||
#### 2. 将nacos配置为系统服务，并且设置开机自启动
|
||||
创建 `/lib/systemd/system/nacos.service`：
|
||||
```ini
|
||||
[Unit]
|
||||
Description=nacos
|
||||
After=network.target
|
||||
|
||||
|
||||
[Service]
|
||||
Type=forking
|
||||
ExecStart=/opt/nacos/bin/startup.sh -m standalone
|
||||
ExecReload=/opt/nacos/bin/shutdown.sh
|
||||
ExecStop=/opt/nacos/bin/shutdown.sh
|
||||
PrivateTmp=true
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
|
||||
```
|
||||
#### 3.重新加载系统服务，启用nacos服务并开启。
|
||||
```bash
|
||||
systemctl daemon-reload
|
||||
systemctl enable nacos.service
|
||||
systemctl start nacos.service
|
||||
|
||||
```
|
||||
---
|
||||
|
||||
### 五、Minio 部署
|
||||
|
||||
#### 1. 安装与启动
|
||||
```bash
|
||||
#在/opt目录（可自定义）下创建目录minio，及其子目录bin、conf、data、logs、target，下载minio至target目录中，并为其添加可执行权限。
|
||||
cd /opt
|
||||
mkdir minio
|
||||
cd ./minio
|
||||
mkdir bin conf data logs target
|
||||
cd target
|
||||
wget https://dl.min.io/server/minio/release/linux-amd64/minio
|
||||
chmod +x minio
|
||||
|
||||
|
||||
# 启动脚本
|
||||
$ vim bin/startup.sh
|
||||
#!/bin/bash
|
||||
export BASE_DIR=`cd $(dirname $0)/..; pwd`
|
||||
export MINIO_ROOT_USER=minioadmin
|
||||
export MINIO_ROOT_PASSWORD=minioadmin
|
||||
if [ ! -d "${BASE_DIR}/conf" ]; then
|
||||
mkdir ${BASE_DIR}/conf
|
||||
fi
|
||||
if [ ! -d "${BASE_DIR}/data" ]; then
|
||||
mkdir ${BASE_DIR}/data
|
||||
fi
|
||||
if [ ! -d "${BASE_DIR}/logs" ]; then
|
||||
mkdir ${BASE_DIR}/logs
|
||||
fi
|
||||
nohup /opt/minio/target/minio server --address :9000 --console-address :19678 /home/cb/miniodata > /opt/minio/logs/miniostart.log &
|
||||
echo "minio is starting, you can check the ${BASE_DIR}/logs/start.out"
|
||||
$ chmod u+x bin/startup.sh
|
||||
|
||||
# 停止脚本
|
||||
$ vim bin/shutdown.sh
|
||||
!/bin/bash
|
||||
target_dir=`cd $(dirname $0)/../target; pwd`
|
||||
pid=`ps ax | grep ${target_dir} | grep -v grep | awk '{print $1}'`
|
||||
if [ -z "$pid" ] ; then
|
||||
echo "No minio server is running."
|
||||
exit -1;
|
||||
fi
|
||||
kill ${pid}
|
||||
echo "Send shutdown request to minio server OK."
|
||||
$ chmod u+x bin/shutdown.sh
|
||||
|
||||
# 将minio配置为系统服务，并且设置开机自启动
|
||||
$ cd /lib/systemd/system
|
||||
$ vim minio.service
|
||||
[Unit]
|
||||
Description=minio
|
||||
After=network.target
|
||||
[Service]
|
||||
Type=forking
|
||||
ExecStart=/opt/minio/bin/startup.sh
|
||||
ExecReload=/opt/minio/bin/shutdown.sh
|
||||
ExecStop=/opt/minio/bin/shutdown.sh
|
||||
PrivateTmp=true
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
|
||||
# 重新加载系统服务，启用minio服务并开启。
|
||||
$ systemctl daemon-reload
|
||||
$ systemctl enable minio.service
|
||||
$ systemctl start minio.service
|
||||
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 六、服务端部署
|
||||
|
||||
#### 1. 目录准备
|
||||
```bash
|
||||
mkdir -p /opt/dkha/{bin,conf,data,logs,target}
|
||||
```
|
||||
#### 2. 代码打包上传
|
||||
```bash
|
||||
#执行maven的打包命令，将生成的jar包上传至target目录，包括school-dkha-admin-server.jar、school-dkha-auth.jar、school-dkha-gateway.jar、school-dkha-portal-server.jar，为上述jar包添加可执行权限。
|
||||
$ mvn package
|
||||
$ chmod u+x target/*
|
||||
|
||||
|
||||
```
|
||||
|
||||
#### 3. 启动脚本
|
||||
创建 `/opt/dkha/bin/startup.sh`：
|
||||
```bash
|
||||
#!/bin/bash
|
||||
error_exit ()
|
||||
{
|
||||
echo "ERROR: $1 !!"
|
||||
exit 1
|
||||
}
|
||||
if [ -z "$JAVA_HOME" ]; then
|
||||
error_exit "Please set the JAVA_HOME variable in your environment, we need java(x64)! jdk8 or later is better!"
|
||||
fi
|
||||
export BASE_DIR=`cd $(dirname $0)/..; pwd`
|
||||
if [ ! -d "${BASE_DIR}/logs" ]; then
|
||||
mkdir ${BASE_DIR}/logs
|
||||
fi
|
||||
for SERVICE in `cd $BASE_DIR/target; ls`; do
|
||||
SERVICE_NAME=${SERVICE%\.*}
|
||||
echo "Service ${SERVICE_NAME} is starting..."
|
||||
nohup java -Dspring.profiles.active=prod -jar ${BASE_DIR}/target/${SERVICE} > ${BASE_DIR}/logs/${SERVICE_NAME}.out 2>&1 &
|
||||
done
|
||||
echo "UP-portal server startup successfully!"
|
||||
$ chmod u+x bin/startup.sh
|
||||
|
||||
#注释：若运行脚本无效，则可在目录下单独运行所有jar包
|
||||
nohup java -jar school-dkha-portal-server.jar --spring.profiles.active=prod &
|
||||
|
||||
```
|
||||
#### 4. 停止脚本
|
||||
```bash
|
||||
$ vim bin/shutdown.sh
|
||||
#!/bin/bash
|
||||
target_dir=`cd $(dirname $0)/../target; pwd`
|
||||
pid=`ps ax | grep ${target_dir} | grep java | grep -v grep | awk '{print $1}'`
|
||||
if [ -z "$pid" ] ; then
|
||||
echo "No UP-portal server is running."
|
||||
exit -1;
|
||||
fi
|
||||
kill ${pid}
|
||||
echo "Send shutdown request to UP-portal server OK."
|
||||
$ chmod u+x bin/shutdown.sh
|
||||
|
||||
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 注意事项
|
||||
1. **路径调整**：所有 `/opt/` 下的路径需根据实际部署位置修改
|
||||
2. **安全配置**：
|
||||
- MySQL 密码 `123456`、Redis 密码 `your_password` 等需替换为强密码
|
||||
- Minio 的 `MINIO_ROOT_USER` 和 `MINIO_ROOT_PASSWORD` 需修改
|
||||
3. **端口冲突**：检查 `9000`（Minio）、`9080`（服务端）等端口是否被占用
|
||||
4. **日志监控**：定期查看 `/opt/dkha/logs/` 和 `/opt/minio/logs/` 下的日志文件
|
||||
Loading…
Reference in New Issue