一、启动项目
项目地址：
git clone https://github.com/curtinlv/pkc-ys.git
1. 使用 Python 启动
如果您希望通过 Python 启动 PKC 音色管理后台，首先确保您的环境中已安装 Python 和相关的依赖项。
步骤：
①安装依赖项
首先，打开终端，进入到项目目录并安装依赖库：
pip install -r requirements.txt
②启动项目
进入到项目根目录后，使用 nohup 启动后台应用，确保应用能够在后台持续运行：
# 进入项目目录
cd PKCYsManage
# 启动项目并将日志输出重定向到 nohup.out
nohup python3 main.py &
# 查看日志输出
tail -f nohup.out
使用 nohup 命令，可以让您的程序在关闭终端后依然保持运行。
2. 使用 Docker 启动
docker run -d -p 39900:39900 -e PKC_USER=pkc -e PKC_PASSWORD=pkc --name pkc-ys curtinlv/pkc-ys
参数说明：
-
-p 39900:39900：将容器内部的 39900 端口映射到主机的 39900 端口，方便访问。 -
-e PKC_USER=pkc：设置默认的用户名为pkc（可以根据需要修改）。 -
-e PKC_PASSWORD=pkc：设置默认的密码为pkc（可以根据需要修改）。 -
查看容器状态
使用以下命令查看正在运行的容器：
docker ps
3. 使用 Docker Compose 启动（推荐方式）
-
①创建docker-compose.yml文件
在项目根目录下创建一个
docker-compose.yml文件，文件内容如下：version: '3.3' services: pkc-ys: image: curtinlv/pkc-ys container_name: pkc-ys ports: - "39900:39900" environment: - PKC_TITLE=PKC音色管理系统 # 系统名称，方便在界面显示 - PKC_USER=pkc # 用户名，默认是 pkc - PKC_PASSWORD=pkc # 密码，默认是 pkc - PKC_MY=1d5ee08d-96f4-4acf-866e-07adb8781184 # 接口密钥 volumes: - ./backup:/app/backup # 音色备份目录，持久化数据 - /etc/localtime:/etc/localtime:ro # 保持主机时间与容器一致 restart: unless-stopped # 除非手动停止，容器会自动重启 -
②启动服务
在包含
docker-compose.yml文件的目录下，执行以下命令启动服务：docker-compose up -d-d参数使服务在后台运行。 -
二、访问地址
启动服务后，您可以通过以下地址访问 PKC 音色管理后台：
音色管理后台
默认的登录用户名：pkc
默认的登录密码：pkc
访问地址：
http://<ip>:39900
请将 <ip> 替换为您服务器的 IP 地址。
音色列表接口
音色列表接口允许您获取当前系统中的所有音色数据，您可以通过以下接口进行访问：
http://<ip>:39900/ysList
三、常用 Docker 命令
以下是一些常用的 Docker 命令，可帮助您管理容器、查看日志和执行常见操作：
查看当前正在运行的容器：
-
docker ps 更新容器配置 如果您修改了 docker-compose.yml配置文件，或需要重新启动服务，可以使用以下命令：docker-compose up -d -
查看所有容器（包括停止的容器）
docker ps -a -
查看容器的实时日志，方便调试和排查问题：
docker logs -f pkc-ys -
如果需要重启容器，可以使用以下命令：
docker restart pkc-ys -
停止正在运行的容器：
docker stop pkc-ys -
启动已停止的容器：
docker start pkc-ys -
删除不再需要的容器：
docker rm pkc-ys
