# 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/` 下的日志文件