主站品牌定制

第十二章　TOTP Vault 自有品牌定制

#65. 最推荐：后台直接修改品牌

宝塔面板

🧰 执行位置：管理员后台 → 系统设置

当前程序已经支持不改源码直接配置：

Website Name
Website Subtitle
Footer
SEO Title
SEO Description
Logo
Favicon

Logo 要求：

PNG
最大 512 KB
推荐正方形透明背景
推荐至少 128×128

Favicon：

PNG
最大 512 KB
推荐 64×64 或 128×128

核对 / 预期结果

✅ 说明

后台上传的品牌图片会存入设置数据库，并随 AGE 数据备份一起保存。日常给自己的网站换品牌时，优先用这个方式，不需要 SSH、不需要改 PHP。

#66. 网站名称与 .env 的关系

服务器 SSH / 终端

🖥️ 执行位置：服务器 SSH / 终端

.env 中：

APP_NAME="TOTP Vault"

是默认回退值。

已经安装并在后台设置过 Website Name 后，优先使用数据库中的 website_name。

如果你制作一个要重新发布给其他人的品牌发行版，可以修改：

.env.example

例如：

APP_NAME="Your Brand 2FA"

#67. 修改发布包默认 Logo 与 Favicon

服务器 SSH / 终端

🖥️ 执行位置：源码目录 / Codex

默认资源：

public/assets/logo.svg
public/favicon.svg

如果后台从未上传品牌图片，程序会回退到这两个文件。

因此，制作自己的发行版时可以替换它们。

注意

⚠️ 不要把自己的私钥、Token 或真实 Secret 放进 Logo 目录或源码包。

#68. 修改后台固定副标题

服务器 SSH / 终端

🖥️ 执行位置：源码目录 / Codex

当前管理后台存在固定英文：

Private Admin Vault

位置：

resources/views/layouts/admin.php
resources/views/admin/login.php

可以改为例如：

Your Brand Security Console

修改后语法检查：

/www/server/php/82/bin/php -l resources/views/layouts/admin.php
/www/server/php/82/bin/php -l resources/views/admin/login.php

#69. 修改网站主题色

服务器 SSH / 终端

🖥️ 执行位置：源码目录 / Codex

打开：

public/assets/app.css

顶部有：

:root {
    --brand: #4f46e5;
    --brand-dark: #4338ca;
    --brand-soft: #eef2ff;
}

只修改这三个品牌变量，就能统一改变：

主按钮
链接
图标
高亮背景
进度条
侧栏选中状态

CSS 改完如果浏览器仍显示旧颜色，先强制刷新：

Ctrl + F5

或者把模板引用中的：

app.css?v=1.2.0

升级一个静态资源版本号。

#70. 修改 SEO

宝塔面板

🧰 执行位置：管理员后台 → 系统设置

直接填写：

SEO Title
SEO Description

公开首页会使用这些内容。

Direct TOTP 页面始终：

noindex
nofollow
noarchive

不要为了 SEO 去掉 Direct 页面的 noindex。

#71. 品牌修改后检查

浏览器 / Microsoft Entra

🌐 执行位置：浏览器

依次打开：

/
/admin/login
/admin
/admin/settings
/2fa/JBSWY3DPEHPK3PXP

核对：

Logo
Favicon
Website Name
后台标题
公开页标题
Direct TOTP 标题
手机端显示