青龙安装指南

本文将基于青龙官方文档，为你详细介绍多种安装青龙的方法。青龙是一个支持定时任务管理的开源工具，常用于脚本自动化、数据采集等场景。无论你是新手还是资深用户，都能找到适合的安装方式。

一、环境要求

在开始安装前，请确保你的系统满足以下基本要求（基于官方文档）：

硬件配置：
- CPU：无特别要求，青龙支持多平台。
- 内存：建议至少 1GB RAM，以获得更好体验。
软件环境：
- 青龙可以运行在任何支持 Docker 及 Node.js 的平台。推荐使用 Docker 以避免环境配置问题。
- 浏览器支持现代主流浏览器（如 Chrome、Firefox、Edge 等）。
系统兼容性：支持 Linux、Windows（通过 Docker）、macOS 等。本文以 Linux 系统为例。

二、安装方法选择

青龙提供多种安装方式，你可以根据自身需求选择：

面板部署（适合新手）：通过 1Panel 或宝塔面板图形化安装。
容器化部署（推荐）：使用 Docker、Docker Compose 或 Podman，简单高效。
原生安装（高级用户）：直接在 Linux 系统通过 npm 安装。

以下为详细步骤。

方法一：使用面板部署（适合新手）

面板部署提供图形化界面，简化操作。以下以 1Panel 和宝塔面板为例。

1. 通过 1Panel 部署

安装 1Panel 面板：

根据你的系统执行在线安装命令（选择其一）：

RedHat / CentOS：

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sh quick_start.sh

Ubuntu：

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && sudo bash quick_start.sh

Debian：

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh

离线安装：下载离线包（如 1panel-v1.10.0-lts-linux-amd64.tar.gz）到 /tmp目录，然后解压并运行安装脚本：
```
cd /tmp
tar zxvf 1panel-v1.10.0-lts-linux-amd64.tar.gz
cd 1panel-v1.10.0-lts-linux-amd64
/bin/bash install.sh
```

部署青龙：
- 安装完成后，浏览器访问 1Panel 面板，在侧边栏点击“应用商店”，搜索“青龙”，点击安装。
- 设置端口等基本信息（建议选择“端口外部访问”），点击确认。
访问面板：
- 安装完成后，通过设置的域名或 IP 访问，按提示完成初始化配置。

2. 通过宝塔面板部署

安装宝塔面板：

执行对应系统的安装命令（选择其一）：

CentOS：

yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh 3d207099a

Ubuntu/Deepin：

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh 3d207099a

Debian：

wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh 3d207099a

部署青龙：
- 登录宝塔面板，在菜单栏点击“Docker”（首次使用需安装）。
- 在“应用商店”中找到“青龙面板”，点击安装，设置域名等基本信息。
访问面板：
- 通过设置的域名访问，按提示初始化。

方法二：使用容器化部署（推荐）

容器化部署隔离环境，避免依赖问题。以下介绍 Docker、Docker Compose 和 Podman 方式。

1. Docker 部署

安装 Docker（如果未安装）：
```
curl -sSL get.docker.com | sh
```
运行青龙容器：
```
docker run -dit \
  -v $PWD/ql/data:/ql/data \
  -p 5700:5700 \
  -e QlBaseUrl="/" \
  -e QlPort="5700" \
  --name qinglong \
  --hostname qinglong \
  --restart unless-stopped \
  whyour/qinglong:latest
```
- 参数说明：
  - -v $PWD/ql/data:/ql/data：挂载数据目录，持久化存储。
  - -p 5700:5700：映射端口，前者为宿主机端口，后者为容器端口。
  - --restart unless-stopped：容器自动重启。
访问面板：
- 浏览器访问 http://你的IP:5700，完成初始化。

2. Docker Compose 部署

安装 Docker Compose：

curl -L https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

创建并启动服务：

mkdir qinglong
cd qinglong
wget https://raw.githubusercontent.com/whyour/qinglong/master/docker/docker-compose.yml
docker-compose up -d

管理服务：
- 停止服务：docker-compose down
访问面板：同 Docker 方式。

3. Podman 部署（类似 Docker）

安装 Podman（参考 Podman 官网）。

运行容器：

podman run -dit \
  --network bridge \
  -v $PWD/ql/data:/ql/data \
  -p 5700:5700 \
  -e QlBaseUrl="/" \
  -e QlPort="5700" \
  --name qinglong \
  --hostname qinglong \
  docker.io/whyour/qinglong:latest

访问面板：同 Docker 方式。

方法三：Linux 原生安装（高级）

适合熟悉 Linux 环境的用户，需手动配置依赖。

安装依赖环境：

Debian/Ubuntu 系统：

curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS 系统：

curl --silent --location https://rpm.nodesource.com/setup_20.x | sudo bash
sudo yum install -y nodejs

安装青龙：

npm install -g node-pre-gyp pnpm
npm install -g @whyour/qinglong

设置环境变量：
- 根据提示设置 QL_DIR和 QL_DATA_DIR，例如：
```
export QL_DIR="/opt/qinglong"
export QL_DATA_DIR="/opt/qinglong/data"
```
启动服务：
```
qinglong
```
访问面板：通过端口 5700 访问。

三、安装后初始化

无论哪种方式，安装完成后均需：

浏览器访问面板（如 http://IP:5700）。
按提示设置管理员账号、密码等。
登录后，可配置定时任务或导入脚本。

四、总结

本文基于青龙官方文档，汇总了多种安装方式：

新手推荐：使用 1Panel 或宝塔面板，图形化操作简单。
通用推荐：Docker 或 Docker Compose，平衡易用性和灵活性。
高级用户：Linux 原生安装，完全控制环境。

建议根据实际场景选择。如有问题，可参考青龙官方文档或社区。祝你安装顺利！