2.5 KiB
2.5 KiB
后端部署教程
一、环境要求
Python 3.10+（建议 3.12.3）- 操作系统：Windows
- redis：redis版本建议用5.0.10（默认地址
redis://127.0.0.1:6379）
二、 获取机器码并激活
1）获取机器码：
python get_machine_code.py
运行后会获得一个机器码，例如：HERTZ_STUDIO_XXXXXXXXXXXXXXXX
将机器码发给相关技术人员进行激活！
三、初始化配置
1）双击运行init_backend.bat
注：此操作会自动创建环境并下载依赖以及完成数据集迁移
四、配置Django
1）将下载的app注册到django项目中
在根目录下面的hertz_server_django文件夹下面的setting文件（如下图）中注册app
如下图我用到了notice、ai、wiki等模块
2）注册app后配置路由
在根目录下面的hertz_server_django文件夹下面的urls.py文件（如下图）中配置路由
配置路由参考，例如我要配置名为xxx的路由：
path('api/xxx/', include('hertz_studio_django_xxx.urls')),
如下图我配置了notice、ai、wiki等路由
五、启动服务
-
通过python脚本启动（支持端口参数）：
python start_server.py --port 8000 -
通过bat脚本启动（快捷）
双击 start_server.bat
六、默认账号
- 超级管理员：
- 用户名：
hertz - 密码：
hertz
- 用户名：
- 普通用户
- 用户名：
demo - 密码：
123456
- 用户名：
七、问题排查
1）daphne 或 watchdog 未安装：
运行：pip install daphne watchdog -i https://pypi.tuna.tsinghua.edu.cn/simple（start_server.py:1235-1248 有依赖检查）。
2）Redis 未运行：
安装并启动 Redis，或调整 REDIS_URL 指向可用实例。
3）视频检测结果展示不了
需配置ffmpeg环境，参考文章：https://blog.csdn.net/csdn_yudong/article/details/129182648
ffmpeg压缩包在根目录下面的static目录下，如下图。
八、项目结构
- 核心配置：
hertz_server_django/settings.py、hertz_server_django/urls.py - 启动脚本：
start_server.py - 依赖清单：
requirements.txt - 静态资源：
static/，媒体资源：media/
九、快速启动
- 安装依赖：
pip install -r requirements.txt -i https://hertz:hertz@hzpypi.hzsystems.cn/simple/ - 启动服务：
python start_server.py --port 8000