release: prepare Web 2.0.1 automatic strategies and private updates

This commit is contained in:
AttilaNet
2026-11-11 12:52:08 +08:00
parent 5b1ef25048
commit 533280e007
30 changed files with 1177 additions and 107 deletions
+96 -17
View File
@@ -14,6 +14,7 @@ import stat
import tempfile
import threading
from urllib.error import HTTPError
from urllib.parse import urlsplit
from urllib.request import HTTPRedirectHandler, Request, build_opener
import uuid
@@ -21,6 +22,14 @@ REPOSITORY = "attilanet/myrzx_bot"
IMAGE = "ghcr.io/attilanet/myrzx_bot-web"
RELEASES_API = f"https://api.github.com/repos/{REPOSITORY}/releases"
PROTOCOL = 1
TOKEN_FILE_NAME = "update-github-token"
TOKEN_FILE_ENV = "RANCH_WEB_UPDATE_GITHUB_TOKEN_FILE"
_TOKEN_LIMIT = 4096
_RELEASE_FAILURES = {
"check_failed": "GitHub 发布检查失败,请稍后重试。",
"access_denied": "无法访问官方 GitHub 发布(401/403/404);请检查服务端 GitHub Token 文件及私有仓库的只读发布权限。",
"token_file_invalid": "GitHub Token 文件不可用;请检查服务端文件、0600 权限及数据目录 UID 10001 所有权。",
}
_TAG = re.compile(r"v2\.(0|[1-9][0-9]{0,8})\.(0|[1-9][0-9]{0,8})", re.ASCII)
_CURRENT = re.compile(r"v?2\.(0|[1-9][0-9]{0,8})\.(0|[1-9][0-9]{0,8})(\.dev[0-9]+)?", re.ASCII)
_ID = re.compile(r"[0-9a-f]{32}", re.ASCII)
@@ -129,32 +138,93 @@ class _NoRedirect(HTTPRedirectHandler):
return None
def github_releases():
"""Fetch only the fixed public repository. No tokens or asset downloads."""
class GitHubReleaseError(RuntimeError):
"""Fixed, public explanations; never retain credentials or HTTP bodies."""
def __init__(self, code="check_failed"):
self.code = code if code in _RELEASE_FAILURES else "check_failed"
super().__init__(_RELEASE_FAILURES[self.code])
def github_token_path(data_dir=None):
"""An explicit override is a server-side path, never a raw token."""
override = os.environ.get(TOKEN_FILE_ENV)
if override is not None:
if not override or not Path(override).is_absolute():
raise GitHubReleaseError("token_file_invalid")
return Path(override)
return Path(data_dir) / TOKEN_FILE_NAME if data_dir is not None else None
def _validate_token(payload):
try:
token = payload.decode("ascii").rstrip("\r\n")
if not 0 < len(payload) <= _TOKEN_LIMIT or re.fullmatch(r"[!-~]+", token) is None:
raise ValueError
except (UnicodeError, ValueError):
raise GitHubReleaseError("token_file_invalid") from None
return token
def _github_token(data_dir):
path = github_token_path(data_dir)
if path is None:
return None
flags = os.O_RDONLY | getattr(os, "O_NOFOLLOW", 0) | getattr(os, "O_NONBLOCK", 0)
try:
if path.is_symlink():
raise GitHubReleaseError("token_file_invalid")
descriptor = os.open(path, flags)
with os.fdopen(descriptor, "rb") as stream:
info = os.fstat(stream.fileno())
if (not stat.S_ISREG(info.st_mode) or info.st_nlink != 1 or info.st_size > _TOKEN_LIMIT
or (os.name == "posix" and stat.S_IMODE(info.st_mode) != 0o600)):
raise GitHubReleaseError("token_file_invalid")
return _validate_token(stream.read(_TOKEN_LIMIT + 1))
except FileNotFoundError:
if TOKEN_FILE_ENV not in os.environ:
return None # Existing public deployments need no credential.
raise GitHubReleaseError("token_file_invalid") from None
except OSError:
raise GitHubReleaseError("token_file_invalid") from None
def github_releases(data_dir=None):
"""Fetch fixed official releases using only an optional server token file."""
# Validate before loading credentials, even if a caller monkey-patches the URL.
endpoint = urlsplit(RELEASES_API)
if (endpoint.scheme != "https" or endpoint.netloc != "api.github.com"
or endpoint.path != f"/repos/{REPOSITORY}/releases" or endpoint.query or endpoint.fragment):
raise GitHubReleaseError()
token = _github_token(data_dir)
opener = build_opener(_NoRedirect())
releases = []
for page in range(1, 11):
request = Request(f"{RELEASES_API}?per_page=100&page={page}", headers={
headers = {
"Accept": "application/vnd.github+json",
"User-Agent": "ranch-web-release-checker/2",
"X-GitHub-Api-Version": "2022-11-28",
})
}
if token is not None:
headers["Authorization"] = f"Bearer {token}"
request = Request(f"{RELEASES_API}?per_page=100&page={page}", headers=headers)
try:
with opener.open(request, timeout=8) as response:
payload = response.read(2 * 1024 * 1024 + 1)
if len(payload) > 2 * 1024 * 1024:
raise ValueError
items = json.loads(payload)
if not isinstance(items, list) or len(items) > 100:
raise ValueError
except HTTPError as error:
if error.code == 404: # A repository without public releases.
return []
raise
if len(payload) > 2 * 1024 * 1024:
raise ValueError("发布列表超出大小限制。")
items = json.loads(payload)
if not isinstance(items, list) or len(items) > 100:
raise ValueError("发布列表格式无效。")
error.close()
raise GitHubReleaseError("access_denied" if error.code in {401, 403, 404} else "check_failed") from None
except Exception:
raise GitHubReleaseError() from None
releases.extend(items)
if len(items) < 100:
return releases
raise ValueError("发布列表超出页数限制,请稍后重试。")
raise GitHubReleaseError()
def official_tags(releases):
@@ -260,13 +330,17 @@ class UpdateService:
state = request["status"]
elif host:
state = host["status"]
failure = cache.get("failure")
failure = failure if isinstance(failure, str) else None
message = (_RELEASE_FAILURES.get(failure, _MESSAGES[state])
if state == "check_failed" else _MESSAGES[state])
result = {
"current_version": self.current_version, "latest_version": latest,
"available": available, "checked_at": timestamp(checked) if checked else None,
"release_url": f"https://github.com/{REPOSITORY}/releases/tag/{latest}" if latest else None,
"channel": "stable-2.x", "repository": REPOSITORY,
"status": state, "message": _MESSAGES[state],
"error": _MESSAGES[state] if state in {"check_failed", "failed", "rolled_back"} else None,
"status": state, "message": message,
"error": message if state in {"check_failed", "failed", "rolled_back"} else None,
"can_apply": available and executor["enabled"] and state not in {"pending", "applying"},
"executor": executor, "request": request, "host_status": host,
}
@@ -275,10 +349,13 @@ class UpdateService:
def check(self):
with self._lock:
try:
tags = official_tags(github_releases())
tags = official_tags(github_releases(self.root))
latest = max(tags, key=stable_version) if tags else None
state = "no_release" if latest is None else "available" if stable_version(latest) > self._current else "up_to_date"
cache = {"status": state, "latest_version": latest, "checked_at": timestamp()}
except GitHubReleaseError as error:
cache = {"status": "check_failed", "failure": error.code,
"latest_version": None, "checked_at": timestamp()}
except Exception:
# Never expose response bodies, proxy addresses, tokens, or paths.
cache = {"status": "check_failed", "latest_version": None, "checked_at": timestamp()}
@@ -299,7 +376,9 @@ class UpdateService:
return state
# Revalidate against live official releases, never just a local cache.
try:
tags = official_tags(github_releases())
tags = official_tags(github_releases(self.root))
except GitHubReleaseError as error:
raise ValueError(str(error)) from None
except Exception:
raise ValueError(_MESSAGES["check_failed"]) from None
target = version or (max(tags, key=stable_version) if tags else None)