# 秘匣（桌面密码管理器）的官网代码

**Repository Path**: liuhangjun/mixia-official

## Basic Information

- **Project Name**: 秘匣（桌面密码管理器）的官网代码
- **Description**: 秘匣（桌面密码管理器）的官方网站，单页展示产品介绍、功能、下载与联系方式。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-15
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 秘匣官网

秘匣（桌面密码管理器）的官方网站，单页展示产品介绍、功能、下载与联系方式。

**官网地址：** https://www.gopassbox.com

本仓库为官网的源码与构建脚本，使用 Go 编写，可打包为单一可执行文件部署。

---

## 功能讲解（官网展示内容）

官网 https://www.gopassbox.com 包含以下板块，并配有产品界面截图：

### 产品介绍

首屏为产品介绍与界面轮播图，便于访客快速了解秘匣的界面与使用方式。

官网轮播使用的截图（将对应图片放入项目 `screenshots/` 目录即可在官网与本文展示）：

| 登录页 | 主界面 | 条目详情 |
|--------|--------|----------|
| ![登录页](screenshots/01-login.png) | ![主界面](screenshots/02-main.png) | ![条目详情](screenshots/03-detail.png) |

| 添加条目 | 设置 |
|----------|------|
| ![添加条目](screenshots/04-add.png) | ![设置](screenshots/05-settings.png) |

### 功能详解

- **账号与主密码**：注册/登录，主密码加密本地密码库，数据仅存本机。

  ![登录页](screenshots/01-login.png)

- **分组与条目**：按分组管理条目（应用名、网站、用户名、密码、手机、邮箱、备注等）。**记住用户名**：登录页可勾选，下次自动填充。

  ![主界面](screenshots/02-main.png)

- **条目详情**：复制用户名/密码、打开网站、生成随机密码等。

  ![条目详情](screenshots/03-detail.png)

- **添加条目**：手动新建或从预设网站模板快速添加。

  ![添加条目](screenshots/04-add.png)

- **导出与导入**：导出为加密 .gopass 文件，支持导入并兼容旧版 .csv。**修改主密码**：在设置中修改，本地库自动重加密。**版本号与界面**：窗口与关于页显示版本号，支持中英文、浅色/深色主题。

  ![设置](screenshots/05-settings.png)

### 数据与安全

- 数据只存在用户电脑，不上传服务器或云端。
- 主密码加密，仅用户可打开。
- 可导出加密备份，换机可导入恢复。

### 下载

提供 **macOS**（.dmg）与 **Windows**（.zip）两个版本的下载入口，具体地址与按钮文案由 config 配置：

- `download_url` / `download_label`：macOS 下载链接与按钮文字
- `download_url_win` / `download_label_win`：Windows 下载链接与按钮文字

可配置为相对路径（由本站提供）或完整 URL（外链）。详见官网：https://www.gopassbox.com

### 联系我们

展示联系邮箱与备案号（桂 ICP）。

---

## 开发与部署

### 运行

**本地开发（无需打包）：**

```bash
go run .
```

默认访问 http://localhost:8080。端口由 config.json 或程序默认决定。

**使用管理脚本（需先打包）：**

```bash
./manage.sh start   # 后台启动
./manage.sh stop    # 停止
./manage.sh restart # 重启
./manage.sh status  # 状态
./manage.sh run     # 前台运行
```

脚本仅执行当前目录下的 `mixia-official`，请先将打包产物拷到运行目录或在该目录执行 `go build -o mixia-official .`。

### 打包

```bash
./build.sh
```

按提示选择目标平台（1=Linux amd64，2=Linux arm64，3=macOS amd64，4=macOS arm64，0=全部），再选择环境（1=开发，2=生产）。产物在 `dist/` 下。

可通过环境变量指定环境：`BUILD_ENV=prod ./build.sh`。

### 配置

- **无 config.json**：使用内置默认（开发环境、HTTP 8080），前端配置由服务端默认生成。
- **有 config.json**：从运行目录读取（或 `CONFIG_PATH`），用于端口、生产/SSL、下载地址与版本号等；服务端据此生成 `/config.js`。

配置模板在 `configs/` 下（config.dev.json / config.prod.json）。打包时选择环境后会复制为 `dist/config.json`。

### 部署目录说明

| 项 | 说明 |
|----|------|
| **mixia-official** | 必选，可执行文件。 |
| **config.json** | 可选。生产部署时放置，用于端口、SSL、下载地址等。 |
| **downloads/** | 可选。放置安装包时，将 config 中 `download_url`/`download_url_win` 设为相对路径（如 `downloads/秘匣-macOS.dmg`、`downloads/秘匣-Windows.zip`）；若为完整 URL 则可不建。 |
| **ssl/** | 可选。生产且 `enable_ssl: true` 时放置证书与私钥，启用 HTTPS。 |

示例：https://www.gopassbox.com 即由 mixia-official + config.json + downloads/ + ssl/ 部署。

### 项目结构（简要）

```
├── main.go           # 入口与 HTTP 服务
├── config/           # 配置加载逻辑
├── configs/          # 环境配置模板
├── index.html        # 官网页面（与 logo、icon、screenshots、downloads 一并嵌入）
├── build.sh          # 交互式打包
├── manage.sh         # 进程管理
├── go.mod
└── README.md
```

### 环境要求

- Go 1.21+