> For AI agents: the complete documentation index is available at https://docs.vps.town/llms.txt, the full documentation bundle is available at https://docs.vps.town/llms-full.txt.

# 如何在 VPS.Town 服务器上安装并配置青龙面板

:::tip 温馨提示

本文由用户 `biebiele` 撰写，并已加入 `VPS.Town 优秀原创文章激励计划`，本站享有完整版权，未经允许不得转载。

本文已通过 [VPS.Town 社区文章投稿及奖励规则 (试行稿)](https://docs.vps.town/kb/community.md) 审核，并获得 `现金 150 元` (共三篇文章) 奖励。

:::

:::details 📖 本文目录

[](#1-安装-docker-和-docker-compose)[](#11-更新软件包索引)[](#12-添加-docker-仓库)[](#13-安装-docker-和-docker-compose)[](#2-安装青龙面板)[](#21-创建路径)[](#22-创建-docker-compose-文件)[](#23-启动青龙面板)[](#24-安装完成)[](#3青龙面板配置)[](#31-通知配置)[](#32-用户名密码设置)[](#33-青龙后台)
:::

## 1. 安装 Docker 和 Docker Compose

### 1.1 更新软件包索引

```bash
# 更新软件包索引，下载 Docker 官方 GPG 密钥，并允许所有人读取
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
```

### 1.2 添加 Docker 仓库

```bash
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
```

### 1.3 安装 Docker 和 Docker Compose

```bash
# 更新软件包索引
sudo apt-get update

# 安装docker软件包
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

# 启动docker服务和开机自启
systemctl enable docker
systemctl restart docker

# 验证安装
systemctl status docker
docker compose version
```

验证显示 docker 启动正常，docker compose 版本号显示正常即可，如下图：
![docker验证](/assets/images/how-to-setup-qinglong-vps-town/1.png)

## 2. 安装青龙面板

### 2.1 创建路径

```bash
# 创建路径
mkdir -p /opt/qinglong
cd /opt/qinglong
```

### 2.2 创建 docker compose 文件

创建 docker compose 文件，可修改映射目录./data、映射端口 5700

```bash
sudo cat > /opt/qinglong/docker-compose.yml <<EOF
services:
  web:
    image: whyour/qinglong:latest
    volumes:
      - ./data:/ql/data
    ports:
      - "5700:5700"
    environment:
      QlBaseUrl: '/'
    restart: unless-stopped
EOF
```

### 2.3 启动青龙面板

```bash
# 启动青龙面板
docker compose up -d
```

### 2.4 安装完成

![docker验证](/assets/images/how-to-setup-qinglong-vps-town/2.png)

如下图状态，即启动正常

![docker验证](/assets/images/how-to-setup-qinglong-vps-town/3.png)

## 3、青龙面板配置

- 打开浏览器访问: http\://**ip 地址**:5700
- 首次访问需要设置管理员账号和密码
  ![初始化配置](/assets/images/how-to-setup-qinglong-vps-town/4.png)

### 3.1 通知配置

以配置 telegram 机器人为例
![通知配置](/assets/images/how-to-setup-qinglong-vps-town/5.png)

- 先申请个人机器人
  与 [@BotFather](https://t.me/BotFather) 对话，创建机器人
  ![创建机器人](/assets/images/how-to-setup-qinglong-vps-town/6.png)
- 输入机器人名称，**名称需要以 bot 结尾**，然后拿到**token**
  ![机器人token](/assets/images/how-to-setup-qinglong-vps-town/7.png)
- **创建机器人成功后，需要主动对话一次才可使机器人实际生效**
- 获取个人 userid
  与 [@userinfobot](https://t.me/userinfobot) 对话，随便输入，拿到个人**userid**
  ![userid](/assets/images/how-to-setup-qinglong-vps-town/8.png)

**把上方获取到的机器人 token 和个人 userid 填入上方的通知配置中**

### 3.2 用户名、密码设置

保存后，输入用户名和密码后登陆后台
![用户名密码设置](/assets/images/how-to-setup-qinglong-vps-town/9.png)

### 3.3 青龙后台

![青龙后台](/assets/images/how-to-setup-qinglong-vps-town/10.png)
