青龙面板怎么搭建

<think>我们正在回答用户关于如何在服务器上搭建青龙面板的问题。根据用户提供的引用，我们有多个不同的安装方法，主要使用Docker进行部署。我们将综合这些引用，给出一个清晰、步骤详细的安装教程。 注意：青龙面板是一个支持Python3、JavaScript、Shell、TypeScript的定时任务管理平台，常用于运行各种脚本。 我们将按照以下步骤进行： 1. 准备环境：确保服务器已安装Docker和Docker Compose。 2. 创建目录并下载配置文件（如果使用docker-compose方式）。 3. 运行容器。 4. 访问面板并进行初始化配置。 由于引用中有多种安装方式，我们选择其中一种较为通用的方式（使用docker-compose）进行说明，同时也会提到直接使用docker run命令的方法，供用户选择。 步骤详细说明： 一、安装Docker和Docker Compose（如果尚未安装） 二、使用docker-compose方式部署（引用1和引用4提供了不同的docker-compose方式，我们综合一下） 三、使用docker run方式部署（引用2和引用3提供了这种方式） 四、访问面板 我们首先介绍docker-compose方式，因为这种方式更便于管理。 注意：以下操作假设您的服务器系统为Linux（如CentOS、Ubuntu等），并且以root用户操作。如果不是root用户，请在命令前加上sudo。 步骤一：安装Docker和Docker Compose 1. 安装Docker： ``` curl -fsSL https://get.docker.com | bash -s docker ``` 2. 启动Docker并设置开机自启： ``` systemctl start docker systemctl enable docker ``` 3. 安装Docker Compose： ``` curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose chmod +x /usr/local/bin/docker-compose ``` 步骤二：使用docker-compose方式部署（推荐） 1. 创建目录并进入： ``` mkdir qinglong && cd qinglong ``` 2. 下载docker-compose.yml文件（引用1）： ``` wget https://raw.githubusercontent.com/whyour/qinglong/master/docker/docker-compose.yml ``` 注意：如果下载地址失效，可以尝试使用备用地址（如引用4中的命令参数）或者使用下面的docker run方式。 3. 启动容器： ``` docker-compose up -d ``` 等待一段时间，容器就会在后台运行。 4. 停止容器（如果需要）： ``` docker-compose down ``` 步骤三：使用docker run方式部署（备选） 如果不想使用docker-compose，可以直接使用docker run命令（引用2、3、4提供了类似的命令，但参数略有不同）。这里我们采用引用3的命令，因为它映射的卷更全面： 1. 创建目录（如果尚未创建）： ``` mkdir -p ql/config ql/log ql/db ql/repo ql/raw ql/scripts ql/jbot ql/deps ql/ninja ``` 2. 运行容器： ``` docker run -dit \ -v $PWD/ql/config:/ql/config \ -v $PWD/ql/log:/ql/log \ -v $PWD/ql/db:/ql/db \ -v $PWD/ql/repo:/ql/repo \ -v $PWD/ql/raw:/ql/raw \ -v $PWD/ql/scripts:/ql/scripts \ -v $PWD/ql/jbot:/ql/jbot \ -v $PWD/ql/deps:/ql/deps \ -v $PWD/ql/ninja:/ql/ninja \ -p 5700:5700 \ -p 5701:5701 \ --name qinglong \ --hostname qinglong \ --restart unless-stopped \ whyour/qinglong:latest ``` 注意：引用4中使用了`--privileged=true`参数，如果您在运行过程中遇到权限问题，可以加上这个参数。 步骤四：访问青龙面板 容器启动后，可以通过浏览器访问： http://服务器IP地址:5700 首次访问会进入初始化配置界面，按照提示设置管理员账号和密码，并可以选择通知方式（如邮箱等）。 注意：如果服务器有防火墙（如firewalld或ufw），请确保放行5700端口（以及5701端口，如果映射了的话）。如果是云服务器，还需要在安全组规则中放行相应端口。 步骤五：安装依赖（可选） 引用5中列出了一些依赖，这些依赖是运行某些脚本所需要的。可以在青龙面板的“依赖管理”中安装，也可以通过容器内的命令行安装。 例如，进入容器： ``` docker exec -it qinglong bash ``` 然后在容器内使用pnpm或npm安装依赖，例如： ``` pnpm install -g png-js pnpm install -g date-fns ...（其他依赖） ``` 或者在青龙面板的“依赖管理”页面添加依赖，选择对应的类型（Python、Node.js等）并安装。 至此，青龙面板已经搭建完成。 常见问题： 1. 如果无法访问，请检查容器是否正常运行：`docker ps` 2. 查看日志：`docker logs qinglong` 我们建议使用docker-compose方式，因为管理容器（启动、停止）更加方便。 根据引用，我们提供了两种部署方式，用户可以根据自己的喜好选择。 注意：青龙面板的镜像和配置可能会更新，请关注官方文档。 最后，我们生成相关问题： 1. 如何更新青龙面板到最新版本？ 2. 青龙面板如何配置多账号？ 3. 青龙面板的常见问题及解决方法有哪些？</think>### 青龙面板部署教程 青龙面板是基于 Docker 的定时任务管理平台，支持 Python、JavaScript、Shell 等脚本。以下是详细部署步骤（以 CentOS 系统为例）： #### 一、环境准备 1. **安装 Docker** ```bash sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install docker-ce docker-ce-cli containerd.io sudo systemctl start docker && sudo systemctl enable docker ``` 2. **安装 Docker Compose** ```bash sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose ``` #### 二、部署青龙面板（推荐 docker-compose 方式） ```bash mkdir qinglong && cd qinglong wget https://raw.githubusercontent.com/whyour/qinglong/master/docker/docker-compose.yml docker-compose up -d # 启动容器 ``` #### 三、验证安装 ```bash docker ps # 应显示运行中的qinglong容器 ``` 访问面板：`http://服务器IP:5700` 首次登录需完成初始化设置（创建管理员账号） #### 四、目录结构说明 ```tree qinglong ├── docker-compose.yml └── ql ├── config # 配置文件 ├── scripts # 脚本目录 ├── log # 日志文件 └── db # 数据库 ``` #### 五、常用命令 | 操作 | 命令 | |------|------| | 启动 | `docker-compose start` | | 停止 | `docker-compose stop` | | 更新 | `docker-compose pull && docker-compose up -d` | | 删除 | `docker-compose down -v` | #### 六、配置优化 1. **修改时区**（在 docker-compose.yml 中添加）： ```yaml environment: - TZ=Asia/Shanghai ``` 2. **开放防火墙端口**： ```bash sudo firewall-cmd --permanent --add-port=5700/tcp sudo firewall-cmd --reload ``` #### 七、依赖安装 在面板「依赖管理」中添加常用依赖： ``` Nodejs crypto-js date-fns axios Python requests beautifulsoup4 ``` > 注意：云服务器需在安全组放行 5700 端口[^1][^4] --- ### 常见问题解决 1. **无法访问面板** - 检查防火墙/安全组设置 - 执行 `docker logs qinglong` 查看容器日志 2. **脚本执行报错** - 在「依赖管理」中安装缺失模块 - 检查脚本执行权限 3. **数据备份** 定期备份 `ql` 目录下的 config、scripts 和 db 子目录 --- ### 相关问题 1. 如何更新青龙面板到最新版本？ 2. 青龙面板如何配置多账号管理？ 3. 如何添加自定义脚本到青龙面板？ 4. 青龙面板的安全防护措施有哪些？ 5. 如何迁移青龙面板到新服务器？ > 参考部署文档：[官方 GitHub](https://github.com/whyour/qinglong) | [阿里云教程][^2] | [保姆级教程][^4]