# sslcloudHtml

**Repository Path**: skyllyf/sslcloudHtml

## Basic Information

- **Project Name**: sslcloudHtml
- **Description**: sslcloud
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-12
- **Last Updated**: 2026-10-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# sslcloudHtml

「宝塔SSL证书自动化插件」（[cloudbt-sslauto](https://cnb.cool/iskyxworkstation/cloudbt-sslauto)）的官方介绍主页。

单页面静态站点，零外部依赖（无 CDN、无字体库、无 JS 框架），可直接部署到任意 Nginx / Apache 静态目录。

## 目录结构

```
sslcloudHtml/
├── index.html          单页入口（唯一页面）
├── css/
│   └── style.css       全部样式（设计变量集中在文件头部）
├── js/
│   ├── mobile-guard.js 移动端访问拦截（<head> 同步加载，防内容闪现）
│   ├── config.js       站点配置唯一真源（版本号 / 下载地址 / 版权）
│   └── main.js         配置填充、代码块复制、顶栏滚动效果
├── res/
│   ├── icon.png        插件图标（与插件仓库 sslauto/icon.png 同源）
│   └── favicon.png     站点图标
└── README.md
```

## 移动端访问限制

宝塔面板插件必须通过 PC 浏览器完成导入安装，本站因此**完全拦截移动端**：

1. `js/mobile-guard.js` 在 `<head>` 同步执行 UA 检测（Android / iPhone / iPad 等），命中即在 `<html>` 上加 `is-mobile`，正文不渲染、只显示提示页；
2. CSS 兜底：`@media (max-width: 768px) and (pointer: coarse)`，即使浏览器开启「请求桌面版站点」改写了 UA，窄屏触摸设备依然被拦截；
3. 调试逃生口：URL 追加 `?force_pc=1` 可在移动端强制查看 PC 版，仅用于开发者自测。

验证方法：浏览器 DevTools → 切换设备模拟（如 iPhone 14），刷新后应只见「请在电脑上打开本页面」。

## 站点配置（长期维护只改这里）

版本号、下载地址、版权主体等全部集中在 **`js/config.js`**，页面通过 `data-config` 挂点自动读取，改配置无需动 HTML：

| 配置项 | 说明 | 当前值 |
|---|---|---|
| `version` | 插件版本号，与插件仓库 `info.json` 保持一致 | `1.0.3` |
| `downloadUrl` | 「下载插件」按钮指向（公开仓库） | CNB 公开镜像 |
| `repoUrl` | 「查看源码」按钮指向 | CNB 公开镜像 |
| `issueUrl` | 问题反馈入口 | CNB Issues |
| `authorSite` | 版权主体链接 | `https://www.iskyx.cc` |
| `deployCommand` | 安装方式二的克隆命令代码块 | `git clone ...` |

**部署后还需修改 `index.html` 中 2 处域名占位**（搜索 `TODO-DEPLOY` 定位）：`<link rel="canonical">` 与 `og:url`，替换为宝塔实际绑定的域名。

## 宝塔 Git 部署步骤

### 一、宝塔侧准备

1. 宝塔面板 → **网站 → 添加站点**，域名填实际访问域名（如 `ssl.iskyx.cc`），根目录默认 `/www/wwwroot/<站点名>`，PHP 版本选「纯静态」；
2. 为该站点申请 SSL 证书（Let's Encrypt），并开启「强制 HTTPS」。

### 二、拉取仓库

方式 A —— 宝塔终端（推荐）：

```bash
# 用有权限的账号克隆到站点根目录（私有仓库需填入令牌或配置部署密钥）
git clone https://gitee.com/<你的账号>/sslcloudHtml.git /www/wwwroot/<站点名>
```

方式 B —— 宝塔「文件」页：进入站点根目录 → 顶部「Git」→ 填入仓库地址与凭据克隆。

> 若仓库为私有，建议在 Gitee 生成只读**部署密钥**（仓库 → 管理 → 部署公钥）添加到服务器 `~/.ssh/authorized_keys`，避免把个人令牌写进服务器命令历史。

### 三、后续更新（长期维护）

```bash
cd /www/wwwroot/<站点名>
git pull origin main
```

静态文件即时生效，无需重启任何服务；浏览器端如无变化，按 `Ctrl + F5` 强刷。

## 本地预览

```bash
# 在仓库根目录执行（任选其一）
python -m http.server 8080
# 或
npx serve .
```

浏览器打开 `http://localhost:8080` 即可预览。

> 不要直接双击 `index.html` 用 `file://` 打开：复制按钮的降级路径与部分浏览器安全策略在 `file://` 下行为不一致。

## 与插件仓库的关系

| 仓库 | 地址 | 用途 |
|---|---|---|
| 本仓库 | `gitee.com/<你的账号>/sslcloudHtml` | 插件介绍主页（本站），长期维护 |
| 插件源码 | `gitee.com/skyllyf/cloudbt-sslauto`（私有） | 插件本体开发 |
| 插件公开镜像 | `cnb.cool/iskyxworkstation/cloudbt-sslauto`（公开） | 站点「下载插件 / 查看源码」的落点，访客可匿名访问 |

## 版权

版权所有 © iSkyX · [www.iskyx.cc](https://www.iskyx.cc)