CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

仓库概述

这是 AcePanel 的公共下载资源库，包含面板及各种服务器应用的安装、更新、卸载脚本。仓库内容会定时同步到 dl.acepanel.net 下载节点。

仓库结构

public.sh - 核心公共库，被所有脚本引用。提供系统检测、下载函数 (dl)、错误处理、系统信息等工具函数。
install_alpha.sh - 面板主安装脚本（测试版）
update.sh / uninstall.sh - 面板更新和卸载脚本
acepanel.service - 面板的 systemd 服务文件

应用目录

每个应用都有独立目录，包含标准化脚本：

install.sh - 安装脚本
update.sh - 更新脚本
uninstall.sh - 卸载脚本

支持的应用：nginx, openresty, php, mysql, mariadb, percona, postgresql, redis, memcached, docker, podman, gitea, code-server, frp, fail2ban, minio, phpmyadmin, pureftpd, rsync, s3fs, supervisor, apache 等

PHP 扩展

php_exts/ 目录包含 PHP 扩展安装脚本（swoole, redis, imagick, xdebug, grpc 等）

脚本规范

所有脚本遵循以下模式：

#!/bin/bash
source <(curl -f -s --connect-timeout 10 --retry 3 https://dl.acepanel.net/public.sh)

public.sh 提供的关键变量

$OS - 检测到的系统类型：rhel、debian、ubuntu 或 unknown
$VERSION - 系统主版本号
$ARCH - 架构：x86_64 或 aarch64
$MEM / $SWAP - 内存和交换分区大小（MB）
$CORES - CPU 核心数
$setup_path - 安装根目录（默认：/opt/ace）
$download_endpoint - 下载服务器地址

public.sh 提供的关键函数

dl <保存目录> <服务器路径> [文件名] - 使用 aria2c 下载文件并进行 SHA256 校验
error <消息> - 输出错误信息并退出
sys_info - 输出系统信息
calculate_j / calculate_j2 - 根据内存计算 make -j 参数值

脚本参数

安装脚本通常接收：

$1 - 渠道（如 stable）
$2 - 版本号

CI/CD

GitLab CI（.gitlab-ci.yml）在每次提交时自动为所有跟踪文件生成 .sha256 校验文件。

支持的系统

RHEL 系：Rocky Linux、AlmaLinux、CentOS Stream、阿里云 Linux、TencentOS
Debian 系：Debian 11+、Ubuntu 20.04+
架构：x86_64（需支持 x86-64-v2 指令集）、aarch64

2.4 KiBLFS Raw Permalink Blame History Unescape Escape