安装

CTOUY UNO系统安装教程文档,快速上手,完成系统的部署

环境说明

本项目运行环境参考如下,推荐使用该配置安装系统,以达最佳使用效果。
操作系统:Linux Ubuntu 20.04 LTS
Python版本:3.12.4

Node.js版本:20.10.0
MYSQL版本:>=8.0(硬性要求)

系统 glibc 版本:>=2.28(硬性要求)

系统glibc版本速查(Ubuntu 20.04 LTS一般为2.31 / Centos 8、Debian 10 Buster一般为2.28)


通过宝塔面板安装

我们采用宝塔面板用于安装环境,确保用户能快速完成系统部署,如果你具有一定服务器运维基础,也可以查看通过直接部署、Docker部署的教程。


1 安装宝塔面板

可参考宝塔面板官方教程,操作较简单,此处不做赘述。
宝塔官方地址:https://www.bt.cn/new/index.html


2 安装Python环境

进入宝塔面板,切换到【网站】-【Python项目】的选项卡
QQ_1725093816731.webp

然后点击安装Python版本,出现以下界面,然后我们选择3.12.4进行安装,如果没有找到版本,可以点击更新版本列表
image.webp
出现安装信息,等待安装完毕,时间较久
image.webp
安装完成后我们可以通过版本管理器检查是否成功安装。

QQ_1725094397287.webp


3 安装Node.js环境

同理,我们切到【网站】-【Node项目】的选项卡,使用相同的办法选择20.10.0的node.js版本进行安装。
如果没有找到对应的版本可以【更新版本列表】。
安装完成后我们可以通过版本管理器检查是否成功安装。
QQ_1725094317853.webp


4 下载安装包

点我前往CTOUY UNO最新版下载地址

下载后将文件上传到服务器的任意文件夹进行解压
推荐解压到:/www/wwwroot/ctouy_uno
并在里面创建一个文件夹,名称为:data,用于存储用户上传的文件,也可以根据服务器情况放置到其他目录
上传解压后目录结构如下:
image.webp


5 部署项目后端

回到【网站】-【Python项目】,添加我们的后端项目
各选项参考如下:
项目路径:/www/wwwroot/ctouy_uno/ctouy_uno_backend
项目名称:取一个你喜欢的名字
运行文件:选择项目路径下的gunicorn_config.py
项目端口:8000
Python版本:3.12.4
框架:django
运行方式:gunicorn
网络协议:wsgi
安装依赖包:选择项目路径下的requirements.txt
image.webp

按下确定后,项目依赖包开始安装,随后我们可以点击项目的设置查看项目环境安装进度,等待安装完成image.webp
依赖安装完成后,我们重新点开设置,将进程数量和现成数量都设为1,然后重启项目。
image.webp


6 部署项目前端

回到【网站】-【Node项目】,添加我们的前端项目
各选项参考如下:
项目目录:/www/wwwroot/ctouy_uno/ctouy_uno_frontend/server
项目名称:取一个你喜欢的名字
启用选项:自定义启动命令 - 然后选择文件/www/wwwroot/ctouy_uno/ctouy_uno_frontend/server/index.mjs
项目端口:8001
node版本:v20.10.0
绑定域名:输入你要绑定的域名
695c1fb3b009a317cb59a99e2e7a942a.webp

等待项目安装依赖环境完成后,我们点开设置配置伪静态进行,直接粘贴保存即可。

# 请将伪静态规则或自定义NGINX配置填写到此处
location /api {
  proxy_pass http://127.0.0.1:8000;
  proxy_set_header Host $host:$server_port;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header REMOTE-HOST $remote_addr;
  add_header X-Cache $upstream_cache_status;

  proxy_connect_timeout 30s;
  proxy_read_timeout 86400s;
  proxy_send_timeout 30s;
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";

}

最后重启该前端项目即可生效


7 系统初始化

进入系统初始化页面,即你设置的前端绑定域名
我们设置了ctouy.com,那么对应的地址是ctouy.com/install

7.1用户文件存储目录
一般我们可以使用默认目录,但为了以后数据方便迁移,我们填写之前创建的数据目录(/www/wwwroot/ctouy_uno/data)。
image.webp

7.2 填写你的数据库信息
可在【数据库】-【添加数据库】创建一个新的数据库用于存储数据,
注意,要使用mysql >=8.0的版本进行安装。
如果是自行创建的数据库,主机一般为:localhost或127.0.0.1,端口为3306。
其他情况请按照实际填写
image.webp

7.3 填写你的基本信息

网站域名:一般无需修改,程序自动获取
网站标题:你的网站标题
管理员账号:默认的管理员账号、密码

7.4 等待安装
最后一步开始后进行安装,该步骤一般1分钟内完成。
image.webp
如果大于1分钟依然卡在正在重启CTOUY UNO,你可以到python项目,手动重启后端,然后刷新安装页面即可解决。

7.5 安装完毕
image.webp

出现该提示后系统已完成安装,可正常使用