# django-vue3-admin

**Repository Path**: xinge-ji/django-vue3-admin

## Basic Information

- **Project Name**: django-vue3-admin
- **Description**: django-vue3-admin 是一套全部开源的快速开发平台，毫无保留给个人免费使用、团体授权使用。 django-vue3-admin 基于RBAC模型的权限控制的一整套基础开发平台，权限粒度达到列级别，前后端分离，后端采用django + django-rest-framework，前端采用基于 vue3 + CompositionAPI + typescript + vite + ele
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1088
- **Created**: 2025-04-18
- **Last Updated**: 2025-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# django-vue3-admin 设置

## 环境

Ubuntu 22.04

全程以 root 用户执行

## 安装

Python >= 3.11.0

nodejs >= 16.0

Mysql >= 8.0

Redis 

### Mysql 新建 user/database

```bash
# 安装
sudo apt install mysql-client-core-8.0
sudo apt install mysql-server 

# 登录 mysql
sudo mysql -u root -p
# 新建用户
CREATE USER 'dvadmin3'@'localhost' IDENTIFIED BY 't6NCtd6GJiRsCCGZ';
# 新建数据库
CREATE DATABASE dvadmin3 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;  
# 授权
GRANT ALL PRIVILEGES ON dvadmin3.* TO 'dvadmin3'@'localhost';
FLUSH PRIVILEGES;
# 退出
EXIT;
```

### Redis 设置密码

```bash
# 安装
sudo apt install redis-server

# 打开设置文档
vim /etc/redis/redis.conf
# 找到 #requirepass foobared 后取消注释并保存
# 重启 redis
systemctl restart redis
```

### 开放 8080 端口

步骤1：检查是否安装了ufw
````
sudo ufw status
````

如果没有安装，可以使用以下命令安装：

```
sudo apt update sudo apt install ufw
```

步骤2：启用ufw
```
sudo ufw enable
```

步骤3：打开8080端口

```
sudo ufw allow 8080
```

步骤4：验证设置

```
sudo ufw status
```

这将显示当前防火墙规则，确保8080端口的状态为ALLOW。


## ONLYOFFICE

```ba
# 安装。docker.1ms.run是国内代理，详见 https://www.coderjia.cn/archives/dba3f94c-a021-468a-8ac6-e840f85867ea
docker pull docker.1ms.run/onlyoffice/documentserver
# 开放端口
ufw allow 8088
# 运行
docker run -i -t -d -p 8088:80 --restart=always -e JWT_ENABLED=false -e USE_UNAUTHORIZED_STORAGE=true -e ONLYOFFICE_HTTPS_HSTS_ENABLED=false docker.1ms.run/onlyoffice/documentserver
# 获取id
docker container ls # 假设id为 8e0708fcc0ca
# 修改设置
docker cp 8e0708fcc0ca:/etc/onlyoffice/documentserver/default.json ./
vim default.json
# 修改
"allowPrivateIPAddress": true
"allowMetaIPAddress": true
# 更改并重启
docker cp ./default.json 8e0708fcc0ca:/etc/onlyoffice/documentserver/default.json
docker container restart 8e0708fcc0ca
docker commit 8e0708fcc0ca onlyoffice/documentserver
docker stop 8e0708fcc0ca
# 重新运行
docker run -i -t -d -p 8088:80 --restart=always -e JWT_ENABLED=false -e USE_UNAUTHORIZED_STORAGE=true -e ONLYOFFICE_HTTPS_HSTS_ENABLED=false -v /myfonts:/usr/share/fonts/custom onlyoffice/documentserver
# 获取id
docker container ls # 假设新id为 33ffe03a9eaf
# 运行测试
docker exec 33ffe03a9eaf sudo supervisorctl start ds:example
# 测试通过，删除旧container
docker rmi docker.1ms.run/onlyoffice/documentserver:latest
```

自带字体较少，建议安装微软雅黑、宋体等常用字体

方法：https://github.com/ONLYOFFICE/DocumentServer/issues/1795

## django-vue3-admin

### 克隆项目

```
git clone https://gitee.com/xinge-ji/django-vue3-admin.git
```

### 后端💈

~~~bash
1. 进入项目目录 cd backend
2. (跳过)在项目根目录中，复制 ./conf/env.example.py 文件为一份新的到 ./conf 文件夹下，并重命名为 env.py 
3. (跳过)在 env.py 中配置数据库信息
    mysql数据库版本建议：8.0
    mysql数据库字符集：utf8mb4
4. 安装依赖环境
    pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
5. 执行迁移命令：
    python3 manage.py makemigrations
    python3 manage.py migrate
6. 初始化数据
    python3 manage.py init
7. 初始化省市县数据:
    python3 manage.py init_area
8. 启动项目
    python3 manage.py runserver 0.0.0.0:8000
或使用 uvicorn :
  uvicorn application.asgi:application --port 8000 --host 0.0.0.0 --workers 8
~~~

### 前端♝

```bash
# 进入项目目录
cd web

# 安装依赖
npm config set registry http://mirrors.cloud.tencent.com/npm/
corepack enable
yarn install --registry=http://mirrors.cloud.tencent.com/npm/

# 设置本地环境接口地址
## 修改 .env.development
## 不要设成 localhost 或者 127.0.0.1，OnlyOffice 预览会报错
## VITE_API_URL = 'http://192.168.93.129:8000'

# 设置 OnlyOffice
## 修改 web/public/previewReport.html, web/public/previewData.html 的接口地址
## <script type="text/javascript" src="http://192.168.93.129:8088/web-apps/apps/api/documents/api.js"></script>

# 启动服务
yarn build
npm run dev
# 浏览器访问 http://192.168.93.129:8080
```