# 使用docker安装青龙面板


![image.png](/static/img/8aeddc3dac4b98087af7a5d3b12bc45c.image.webp)

```yaml
services:
  web:
    container_name: qinglong
    image: whyour/qinglong:latest # 基于 Debian 的版本：whyour/qinglong:debian  
    volumes:
      - ./data:/ql/data
    ports:
      - "5700:5700"
    environment:
      QlBaseUrl: '/' # 部署路径非必须，以斜杠开头和结尾，比如 /test/
    restart: unless-stopped
```

# 安装依赖

## nodejs依赖
```js
crypto-js
prettytable
dotenv
jsdom
date-fns
tough-cookie
tslib
ws@7.4.3
ts-md5
jsdom -g
jieba
fs
form-data
json5
global-agent
png-js
@types/node
require
typescript
js-base64
axios
moment
request
ds
crypto -g
-g typescipt
https
proxy
ql
qs
common
cjs
sharp
jsencrypt
node-rsa
xmldom
socks-proxy-agent

```

## python依赖


```js
requests
canvas
ping3
jieba
PyExecJS
aiohttp
redis
httpx
success
bs4
Crypto
openai
dashscope

```

# 安装测速相关依赖


```bash
# 1. 更新Alpine的apk源（换国内源，加快速度）
echo "https://mirrors.aliyun.com/alpine/v3.18/main/" > /etc/apk/repositories
echo "https://mirrors.aliyun.com/alpine/v3.18/community/" >> /etc/apk/repositories

# 2. 更新apk缓存并安装依赖
apk update && apk add --no-cache \
    chromium \
    chromium-chromedriver \
    wget \
    unzip \
    libstdc++ \
    libgcc
# 3. 验证chromedriver是否安装成功
chromedriver --version
chromium --version
# 4. 安装selenium
pip3 install selenium -i https://pypi.tuna.tsinghua.edu.cn/simple

```

# speedtest测速脚本

```py
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
青龙面板测速脚本（网址可配置变量版）
修改下方SPEED_TEST_URL变量即可更换测速网站，无需改核心逻辑
"""
import time
import re
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.options import Options
from selenium.common.exceptions import NoSuchElementException
from selenium.webdriver.chrome.service import Service

# ===================== 可配置变量（重点修改这里） =====================
SPEED_TEST_URL = "https://speedtest.com/"  # 测速网站网址，改这里即可
# ====================================================================

def is_number(s):
    """判断是否为数字（含小数）"""
    try:
        float(s)
        return True
    except:
        return False

def get_element_text(driver, elem_id):
    """安全获取元素的innerText"""
    try:
        elem = driver.find_element(By.ID, elem_id)
        return elem.get_attribute("innerText").strip()
    except:
        return ""

def get_progress_width(driver):
    """精准获取进度条宽度（支持小数，多次提取去重）"""
    try:
        progress_elem = driver.find_element(By.ID, "progress")
        raw_style = progress_elem.get_attribute("style").strip()
        width_match = re.search(r'width:\s*(\d+\.?\d*)%', raw_style)
        
        if width_match:
            width_value = float(width_match.group(1))
            return round(width_value, 1), raw_style
        return 0.0, raw_style
    except Exception as e:
        return 0.0, f"提取失败：{str(e)}"

def speed_test():
    try:
        # ========== 浏览器配置 ==========
        chrome_options = Options()
        chrome_options.add_argument("--headless=new")
        chrome_options.add_argument("--no-sandbox")
        chrome_options.add_argument("--disable-dev-shm-usage")
        chrome_options.add_argument("--disable-gpu")
        chrome_options.add_argument("--no-zygote")
        chrome_options.add_argument("--single-process")
        chrome_options.binary_location = "/usr/bin/chromium"
        chrome_options.add_experimental_option("excludeSwitches", ["enable-automation"])
        chrome_options.add_experimental_option('useAutomationExtension', False)

        # ========== 驱动初始化 ==========
        print("[1/6] 初始化浏览器驱动...")
        chrome_service = Service(executable_path="/usr/bin/chromedriver")
        driver = webdriver.Chrome(service=chrome_service, options=chrome_options)
        driver.set_page_load_timeout(60)
        driver.implicitly_wait(20)

        # ========== 访问测速网站（使用变量） ==========
        print(f"[2/6] 访问测速网站：{SPEED_TEST_URL}...")
        driver.get(SPEED_TEST_URL)  # 替换为变量
        time.sleep(8)  # 等待页面完全加载

        # ========== 强制触发测速 ==========
        print("[3/6] 强制触发测速（调用startStop()）...")
        driver.execute_script("startStop();")
        print("✅ 已执行startStop()函数，开始测速")

        # ========== 等待进度条到100% ==========
        print("[4/6] 等待测速进度条完成（最多120秒）...")
        max_wait = 120
        wait_time = 0
        last_progress = 0.0
        
        while wait_time < max_wait:
            progress_list = []
            raw_style_list = []
            for _ in range(3):
                p, s = get_progress_width(driver)
                progress_list.append(p)
                raw_style_list.append(s)
                time.sleep(0.1)
            
            current_progress = max(progress_list)
            raw_style = raw_style_list[progress_list.index(current_progress)]
            
            if current_progress > last_progress or wait_time % 4 == 0:
                print(f"  进度条：{current_progress}% | 原始style：{raw_style} | 等待时间：{wait_time}/{max_wait}秒")
                last_progress = current_progress
            
            if current_progress >= 100.0:
                print("✅ 进度条已到100%，测速完全结束")
                break
            
            time.sleep(1)
            wait_time += 1
        
        if last_progress < 100.0:
            print(f"⚠️  进度条未到100%（当前{last_progress}%），已超时，提取当前数值")

        # ========== 提取最终数值 ==========
        print("[5/6] 提取最终测速结果...")
        dl_value = get_element_text(driver, "dlText")
        download_speed = f"{dl_value} Mbps" if is_number(dl_value) else f"无效数值（{dl_value}）"
        
        ul_value = get_element_text(driver, "ulText")
        upload_speed = f"{ul_value} Mbps" if is_number(ul_value) else f"无效数值（{ul_value}）"
        
        ping_value = get_element_text(driver, "pingText")
        ping = f"{ping_value} ms" if is_number(ping_value) else f"无效数值（{ping_value}）"

        # ========== 输出最终结果 ==========
        print("\n===== 【F12一致-精准最终结果】 ======")
        print(f"📥 下载速度：{download_speed}")
        print(f"📤 上传速度：{upload_speed}")
        print(f"📶 网络延迟：{ping}")
        print("======================================\n")

        driver.quit()
        return True

    except Exception as e:
        print(f"\n❌ 测速失败：{str(e)}")
        import traceback
        print(f"❌ 详细报错：{traceback.format_exc()}")
        try:
            driver.quit()
        except:
            pass
        return False

if __name__ == "__main__":
    speed_test()
```

# 创建定时任务

![image.png](/static/img/6ff52252143c6ddfdd73d28c572ee254.image.webp)

脚本路径不会填可以通过ssh查询


```ssh
# 查找speedtest相关的脚本文件（不管名字是speedtest.py还是speed_test.py）
find /ql -name "*speedtest*.py"
```

青龙面板添加测速脚本

# dockercompose


```yaml
version: '3.8'
services:
  # easytier 服务配置（核心）
  easytier:
    container_name: easytier            # 容器名称
    image: easytier/easytier:latest     # 使用官方最新镜像
    restart: always                     # 容器退出时自动重启
    privileged: true                    # 特权模式（满足tun设备/网络权限需求）
    hostname: easytier                  # 容器内主机名
    volumes:
      - ./config:/root                  # 挂载本地config目录到容器/root（存放config.yaml）
      - ./data:/data                    # 持久化easytier数据（避免配置丢失）
    environment:
      - TZ=Asia/Shanghai                # 设置容器时区为上海
    network_mode: host                  # 共享宿主机网络栈（easytier必需）
    cap_add:
      - NET_ADMIN                       # 授予网络管理权限（创建tun设备/路由等）
      - NET_RAW                         # 授予原始套接字权限（P2P打洞必需）
    devices:
      - /dev/net/tun:/dev/net/tun       # 挂载tun设备（虚拟网卡，easytier核心依赖）
    command: -c /root/config.yaml       # 指定配置文件启动（替代命令行参数）
```

# 建立文件夹，上传config.yaml文件

![image.png](/static/img/8181c8b33366af659552c826daccc449.image.webp)

[配置文件生成链接](https://easytier.cn/web/index.html#/config_generator)

# 关键参数


```yaml
hostname = "***"
instance_name = "***"
ipv4 = "100.100.100.1/24"
dhcp = false
listeners = [
"tcp://0.0.0.0:10100",
"udp://0.0.0.0:10100",
"wg://0.0.0.0:10101",
"ws://0.0.0.0:10101/",
]

exit_nodes = [
]

[network_identity]
network_name = "***"
network_secret = "****"

[[proxy_network]]
cidr = "192.168.*.0/24"

[[proxy_network]]
cidr = "192.168.*.0/24"

[flags]
# 连接到对等节点使用的默认协议
default_protocol = "tcp"
dev_name = ""
enable_encryption = true
enable_ipv6 = true
mtu = 1380
latency_first = false
enable_exit_node = false
no_tun = false
use_smoltcp = false
# 仅转发白名单网络的流量，支持通配符字符串。多个网络名称间可以使用英文空格间隔。如果该参数为空，则禁用转发。默认允许所有网络。例如：'*'（所有网络），'def*'（以def为前缀的网络），'net1 net2'（只允许net1和net2）
foreign_network_whitelist = "abc"
```

- 子网代理有一个写一个
- 禁用转发可以删除foreign_network_whitelist
- 如果不需要作为组网节点，可以删除network_identity
- listeners中的端口号映射到公网

nas部署easytier并作为共享节点

# 登录控制台

![image.png](/static/img/1cb43840ae637273ba717f4184eb8a81.image.webp)

# 输入quickstart
选择0，显示接口

![image.png](/static/img/778b71388d3a0dec393cee8e66421035.image.webp)
选择1，修改管理后台Ip地址
![image.png](/static/img/519a1131fcd7ee697aca739c15db2bc6.image.webp)

选择quit退出菜单
![image.png](/static/img/94899d975a38f64d2f10d667184ab51b.image.webp)
接着输入reboot重启路由器

# 登录管理页面

默认密码password

![image.png](/static/img/4cc5d0626b32d6ad6e2de16ae400f15a.image.webp)
选择网络向导，选择配置为旁路由

![image.png](/static/img/78cf18fe5360685f54ed41bae3904d5e.image.webp)
选择手动配置

![image.png](/static/img/27528363403be7eef976633bfde3f750.image.webp)

# 如何使用旁路由

需要将设备的网关指向旁路由的IP即可

绿联nas部署istoreos做旁路由

# 说明
Uras官网demo只展示string数组如何使用，如下：

前端
```axaml
    <u:MultiComboBox
        Watermark="Please Select"
        Width="300"
        MaxHeight="200"
        SelectedItems="{Binding SelectedItems}"
        ItemsSource="{Binding Items}" >
    </u:MultiComboBox>
```
后端


```C#
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Windows.Input;
using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;

namespace Ursa.Demo.ViewModels;

public class MultiComboBoxDemoViewModel: ObservableObject
{
    public ObservableCollection<string> Items { get; set; }
    
    public ObservableCollection<string> SelectedItems { get; set; }

    public ICommand SelectAllCommand => new RelayCommand(() =>
    {
        SelectedItems.Clear();
        foreach (var item in Items)
        {
            SelectedItems.Add(item);
        }
    });
    
    public ICommand ClearAllCommand => new RelayCommand(() =>
    {
        SelectedItems.Clear();
    });
    
    public ICommand InvertSelectionCommand => new RelayCommand(() =>
    {
        var selectedItems = new List<string>(SelectedItems);
        SelectedItems.Clear();
        foreach (var item in Items)
        {
            if (!selectedItems.Contains(item))
            {
                SelectedItems.Add(item);
            }
        }
    });
    
    public MultiComboBoxDemoViewModel()
    {
        Items = new ObservableCollection<string>()
        {
            "Item 1",
            "Item 2",
            "Item 3",
            "Item 4",
            "Item 5",
            "Item 6",
            "Item 7",
            "Item 8",
            "Illinois",
            "Indiana",
            "Iowa",
            "Kansas",
            "Kentucky",
            "Louisiana",
            "Maine",
            "Maryland",
            "Massachusetts",
            "Michigan",
            "Minnesota",
            "Mississippi",
            "Missouri",
            "Montana",
            "Nebraska",
            "Nevada",
            "New Hampshire",
            "New Jersey",
            "New Mexico",
            "New York",
            "North Carolina",
            "North Dakota",
            "Ohio",
            "Oklahoma",
            "Oregon",
            "Pennsylvania",
            "Rhode Island",
        };
        SelectedItems = new ObservableCollection<string>();
    }
}

```
# 复杂类型如何使用？

前端
```axaml
<u:MultiComboBox
Width="200"
MaxHeight="200"
SelectedItems="{Binding SelectedGroups}"
ItemsSource="{Binding AlarmGroups}" >
	<u:MultiComboBox.SelectedItemTemplate>
		<DataTemplate x:DataType="vm:AlarmGroupViewModel">
			<StackPanel Orientation="Horizontal">
				<TextBlock Text="{Binding Name}"/>
			</StackPanel>
		</DataTemplate>
	</u:MultiComboBox.SelectedItemTemplate>
	<u:MultiComboBox.ItemTemplate>
		<DataTemplate x:DataType="vm:AlarmGroupViewModel">
			<StackPanel Orientation="Horizontal">
				<TextBlock Text="{Binding Name}"/>
			</StackPanel>
		</DataTemplate>
	</u:MultiComboBox.ItemTemplate>
</u:MultiComboBox>
```

后端
```C#
using Avalonia.Collections;
using Avalonia.Controls.Notifications;
using Avalonia.Threading;
using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;
using Cowain.Base.Helpers;
using Cowain.Base.ViewModels;
using Ke.Bee.Localization.Localizer.Abstractions;
using Plugin.Cowain.Driver.Abstractions;
using Plugin.Cowain.Driver.IServices;
using Plugin.Cowain.Driver.Services;
using SixLabors.Fonts.Tables.AdvancedTypographic;
using System.Collections.ObjectModel;

namespace Plugin.Cowain.Driver.ViewModels;

public partial class AlarmHistoryViewModel : PageViewModelBase
{
    private readonly ILocalizer _l;
    private readonly IAlarmService _alarmService;
    private readonly IAlarmGroupService _alarmGroupService;
    private readonly IAlarmLevelService _levelService;
    public AlarmHistoryViewModel(ILocalizer localizer, IAlarmService alarmService, IAlarmGroupService alarmGroupService, IAlarmLevelService alarmLevelService)

    {
        PageSize = 40;
        _l = localizer;
        _alarmService = alarmService;
        _alarmGroupService = alarmGroupService;
        _levelService = alarmLevelService;
    }

    [ObservableProperty]
    private int _totals;
    [ObservableProperty]
    private int _pageSize;
    [ObservableProperty]
    private int _pageIndex;
    [ObservableProperty]
    private ObservableCollection<AlarmViewModel>? _alarms = new();

    [ObservableProperty] private DateTime? _startDate;
    [ObservableProperty] private DateTime? _endDate;
    [ObservableProperty] private IList<AlarmGroupViewModel>? _selectedGroups = new AvaloniaList<AlarmGroupViewModel>();
    [ObservableProperty] private IList<AlarmLevelViewModel>? _selectedLevels = new AvaloniaList<AlarmLevelViewModel>();
    [ObservableProperty]
    private ObservableCollection<AlarmLevelViewModel>? _alarmLevels;
    [ObservableProperty]
    private ObservableCollection<AlarmGroupViewModel>? _alarmGroups;

    [RelayCommand]
    private async Task LoadedAsync()
    {
        //获取所有设备列表
        var alarmLevels = await _levelService.GetAllAsync();
        AlarmLevels = new ObservableCollection<AlarmLevelViewModel>(alarmLevels);
        var alarmGroups = await _alarmGroupService.GetAllAsync();
        AlarmGroups = new ObservableCollection<AlarmGroupViewModel>(alarmGroups);
    }

    [RelayCommand]
    private async Task RefreshAsync()
    {
        if (StartDate == null)
        {
            NotificationHelper.ShowNormal(NotificationType.Warning, _l["AlarmHistory.Warning.StartDateIsNull"]);
            return;
        }
        if (EndDate == null)
        {
            NotificationHelper.ShowNormal(NotificationType.Warning, _l["AlarmHistory.Warning.EndDateIsNull"]);
            return;
        }
        List<int>? groups = SelectedGroups?.Select(g => g.Id).ToList();
        List<int>? levels = SelectedLevels?.Select(g => g.Id).ToList();
        var (data, count) = await _alarmService.GetAlarmAsync(PageIndex, PageSize, StartDate, EndDate, groups, levels);
        Alarms?.Clear();
        Totals = count;
        if (count > 0)
        {
            foreach (var item in data)
            {
                // 设置报警组名称和等级名称
                item.GroupName = AlarmGroups?.FirstOrDefault(g => g.Id == item.Group)?.Name ?? string.Empty;
                item.LevelName = AlarmLevels?.FirstOrDefault(g => g.Id == item.Level)?.Name ?? string.Empty;
                Alarms?.Add(item);
            }

        }

    }


}
```

# 关键点说明

选中项一定要是IList接口
```C#
    [ObservableProperty] private IList<AlarmGroupViewModel>? _selectedGroups = new AvaloniaList<AlarmGroupViewModel>();
```

avalonia MultiComboBox 绑定复杂对象

# 前置准备：Docker 部署lucky

确保 Lucky 容器已挂载验证文件目录（绿联 NAS 端操作）：


```yaml
services:
  lucky:
    image: gdy666/lucky
    container_name: lucky
    volumes:
      - /volume1/Docker/goodlucky:/goodluck
      - /volume1/Docker/wechat_verify:/wechat_verify  # 微信验证文件目录
    restart: always
    network_mode: host
```

将微信验证文件（如ee9114d394500f07ef00ac39d35c106a.txt）放入 NAS 的 /volume1/Docker/wechat_verify 目录。

# 二、Lucky 端文件服务配置

- 进入 Lucky 后台 → 「Web 服务」→ 点击「添加 Web 服务规则」
- 新建子规则，配置如下：
- 子规则开关：启用
- 操作模式：简易模式
- 前端地址：www.294713.xyz/wechat_verify
- 服务类型：文件服务
- 文件服务挂载路径：
- 挂载类型：本地
- 本地路径：/wechat_verify（容器内挂载路径）
- 显示名称：wechat_verify
- 文件服务设置：显示目录 → 关闭

# 三、阿里云 ESA 端配置

路径重写规则（核心）

![image.png](https://blog.294713.xyz/static/img/30f791b035ef352ed76b46dabac9e6f8.image.webp)
```js
regex_replace(http.request.uri.path, "^/(.*\\.txt)$", "/wechat_verify/$1")
```
回源规则设置参考链接
[https://zhuanlan.zhihu.com/p/1989011620328924699](url)

# 四、验证步骤
访问 https://www.294713.xyz/aaa.txt
若页面直接显示验证文件内容（如54d113ad7da27），则配置成功。