appstore/apps/microwarp

MicroWARP（1Panel v2）

基于 ghcr.io/ccbkkb/microwarp 的轻量级 Cloudflare WARP 代理封装，统一收敛为 microwarp 单 key，并提供官方原版与定时轮换变体。

产品介绍

MicroWARP 将 Cloudflare WARP 封装为可在 1Panel 中直接部署的 SOCKS5 代理；HTTP 变体通过 GOST 额外提供 HTTP 代理端口，rotator 变体负责定时重建 WARP 身份。

主要功能

• 支持 SOCKS5 代理及可选用户名、密码认证
• 支持 SOCKS5-only、SOCKS5 + HTTP、定时轮换三类组合
• 轮换前后通过代理检查真实出口 IPv4，并在同 IP 或检查失败时重试
• 重试耗尽后恢复上一次可用 WireGuard 配置

访问说明

• SOCKS5 端口由 PANEL_APP_PORT_SOCKS5 配置
• HTTP 变体的 HTTP 代理端口由 PANEL_APP_PORT_HTTP_PROXY 配置
• 代理服务不提供 Web 管理界面；请使用对应端口和 SOCKS5/HTTP 客户端连接
• 默认不启用认证，公网部署时建议同时设置 SOCKS_USER 与 SOCKS_PASS

版本说明

latest

• 官方原版
• 仅提供 SOCKS5 代理
• 不做自动 IP 轮换，适合需要稳定出口身份的场景

http-latest

• 官方原版增强变体
• 在 SOCKS5 基础上额外提供 HTTP 代理端口
• 通过 gogost/gost sidecar 将 HTTP 转发到 SOCKS5

0.1.3-rotator

• 基于官方原版增加定时 WARP 身份重建
• 固定使用与当前 latest 清单一致的官方 MicroWARP 0.1.3 镜像
• 轮换通过删除旧 wg0.conf 与账号缓存后重新执行上游初始化完成
• 每次轮换都会通过 SOCKS5 代理读取出口 IPv4；出口未变化或无法确认时自动重试
• 达到尝试次数仍没有新出口时恢复上一次可用配置，避免留下不可用代理
• 轮换时会有秒级短暂中断

0.1.3-rotator-http

• 在 0.1.3-rotator 基础上额外提供 HTTP 代理端口

安装建议

• 只需官方 SOCKS5：安装 latest
• 需官方 SOCKS5 + HTTP：安装 http-latest
• 需要定时切换 WARP 身份：安装 0.1.3-rotator
• 需要定时切换并同时提供 HTTP：安装 0.1.3-rotator-http

核心参数

• PANEL_APP_PORT_SOCKS5：SOCKS5 对外端口
• PANEL_APP_PORT_HTTP_PROXY：HTTP 代理端口，仅 HTTP 变体使用
• APP_DATA_DIR_1：WireGuard 持久化目录，保存 wg0.conf 与 wgcf 注册信息
• SOCKS_USER / SOCKS_PASS：启用 SOCKS5 认证
• ENDPOINT_IP：手动覆盖 WARP Endpoint
• GH_PROXY：辅助 wgcf 下载
• TAILSCALE_CIDR：Tailscale 回程路由 CIDR，默认 100.64.0.0/10
• MTU：WireGuard MTU，默认 1280
• WARP_WGCF_CONF：可选完整 WireGuard 配置内容；也可直接将 wg0.conf 放入持久化目录
• ROTATE_INTERVAL_MINUTES：轮换间隔（分钟），仅 rotator-* 版本使用，0 表示关闭
• ROTATE_MAX_ATTEMPTS：单次轮换最多重建身份的次数，默认 5
• ROTATE_RETRY_DELAY_SECONDS：轮换重试间隔（秒），默认 5
• TEST_URL：启动时通过 SOCKS5 探测代理的 URL
• IP_CHECK_URL：读取出口 IPv4 的 URL，响应需要包含 ip=<IPv4>，默认使用 Cloudflare trace

使用说明

• 默认使用外部网络 1panel-network
• 首次启动会自动注册 WARP 设备并生成 /etc/wireguard/wg0.conf
• 建议保留 APP_DATA_DIR_1 持久化目录，避免每次重启都重新注册
• 官方镜像内部支持通过 GitHub token 缓解 wgcf 版本查询的 API 限流，但本应用默认不在 1Panel 表单中暴露该参数，优先保持默认安装简洁稳定
• 如果设置了 WARP_WGCF_CONF，rotator-* 版本会自动关闭定时轮换，因为该配置已固定出口身份
• rotator-* 版本的轮换逻辑是完整重建 WARP 身份，而不是调用上游并不存在的 rotate API；会比较轮换前后的真实出口 IPv4
• 配置了 SOCKS_USER 和 SOCKS_PASS 时，轮换检查会使用相同的 SOCKS5 认证

升级说明

• 已有 rotator-latest 与 rotator-http-latest 安装可分别直接升级到 0.1.3-rotator 与 0.1.3-rotator-http，不需要中间版本；新版本名用于确保 1Panel 真正提供升级入口
• 旧轮换版本仍保留以兼容既有安装；新安装请选择带 0.1.3 前缀的版本
• 升级会保留 APP_DATA_DIR_1 中的 wg0.conf、WARP 注册信息和用户自定义环境变量；升级前仍建议使用 1Panel 备份该目录
• 1Panel 升级脚本会将当前版本的 rotate.sh 原子替换到已安装目录；若安装目录仍是旧脚本且无法定位新版载荷，升级会失败而不会继续运行旧轮换逻辑，重复执行则保持幂等
• 新增的 ROTATE_MAX_ATTEMPTS、ROTATE_RETRY_DELAY_SECONDS 与 IP_CHECK_URL 在旧 .env 缺失时使用安全默认值，不会覆盖旧的轮换间隔、端口或认证配置
• 升级后首次轮换可能产生秒级中断；若出口 IP 无法变化或无法确认，程序会恢复上一份可用配置

Introduction

MicroWARP packages Cloudflare WARP as a 1Panel-ready SOCKS5 proxy. The HTTP variants add an HTTP proxy through GOST, while the rotator variants rebuild the WARP identity on a schedule and verify the real egress IPv4 through the proxy.

Features

• SOCKS5 proxy with optional username/password authentication
• SOCKS5-only, SOCKS5 + HTTP, and scheduled-rotation variants
• Egress IPv4 verification before and after each rotation
• Retries for unchanged or unverifiable egress, with rollback to the last working WireGuard configuration

Upgrade notes

• Existing rotator-latest and rotator-http-latest installations can upgrade directly to 0.1.3-rotator and 0.1.3-rotator-http; no intermediate version is required. The bumped package versions ensure that 1Panel exposes a real upgrade path.
• The legacy rotator versions remain for existing-install compatibility. New installations should use the 0.1.3-prefixed variants.
• The upgrade preserves APP_DATA_DIR_1, including wg0.conf, WARP registration data, and existing user-defined environment values. Back up that directory through 1Panel before upgrading.
• The 1Panel upgrade script atomically replaces the installed rotate.sh with the target-version payload. If the installed script is still old and that payload cannot be located, the upgrade fails instead of continuing with the old rotation logic; reruns are idempotent.
• The new ROTATE_MAX_ATTEMPTS, ROTATE_RETRY_DELAY_SECONDS, and IP_CHECK_URL variables have safe Compose defaults when they are absent from an older .env; existing rotation interval, ports, and authentication settings are not overwritten.
• The first rotation after an upgrade may briefly interrupt the proxy. If a new or verifiable egress IP cannot be obtained, the last working configuration is restored.