This commit is contained in:
1 parent
b705f00b22
commit
560605a8e1
10 files changed
+360
-13
No files matched your search
@@ -0,0 +1,112 @@
|
||||
// 本工具仅在停服后调整指定配置目录的空白排版,并同步原有文件摘要。
|
||||
package main
|
||||
|
||||
import (
|
||||
"bytes"
|
||||
"crypto/sha256"
|
||||
"encoding/hex"
|
||||
"encoding/json"
|
||||
"errors"
|
||||
"flag"
|
||||
"fmt"
|
||||
"os"
|
||||
"path/filepath"
|
||||
|
||||
"git.pcux.cn/xuans/Smail/utils/atomicfile"
|
||||
)
|
||||
|
||||
func main() {
|
||||
if err := run(); err != nil {
|
||||
fmt.Fprintln(os.Stderr, err)
|
||||
os.Exit(1)
|
||||
}
|
||||
}
|
||||
|
||||
func run() error {
|
||||
directory := flag.String("config", "", "已停止后端的配置目录")
|
||||
backup := flag.String("backup", "", "保存原字节的独立备份目录")
|
||||
apply := flag.Bool("apply", false, "确认停服,执行排版;默认只检查")
|
||||
flag.Parse()
|
||||
if !filepath.IsAbs(*directory) || !filepath.IsAbs(*backup) {
|
||||
return errors.New("配置及备份目录必须使用明确的绝对路径")
|
||||
}
|
||||
info, err := os.Lstat(*directory)
|
||||
if err != nil || !info.IsDir() || info.Mode()&os.ModeSymlink != 0 {
|
||||
return errors.New("配置目录不可用或是链接")
|
||||
}
|
||||
names := []string{"smtp.json", "email.json", "ssl.json", "plugins.json", "config.json"}
|
||||
original, formatted := map[string][]byte{}, map[string][]byte{}
|
||||
for _, name := range names {
|
||||
path := filepath.Join(*directory, name)
|
||||
info, err := os.Lstat(path)
|
||||
if err != nil || !info.Mode().IsRegular() || info.Size() > 4<<20 {
|
||||
return errors.New("配置文件不可用、过大或不是普通文件")
|
||||
}
|
||||
data, err := os.ReadFile(path)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
var result bytes.Buffer
|
||||
// 不解析再编码业务值,保留中文、密文、数字及转义的原始字节。
|
||||
if err := json.Indent(&result, data, "", " "); err != nil {
|
||||
return fmt.Errorf("%s 不是有效 JSON,未写入", name)
|
||||
}
|
||||
original[name], formatted[name] = data, result.Bytes()
|
||||
}
|
||||
var root struct {
|
||||
Sections map[string]struct {
|
||||
File string `json:"file"`
|
||||
SHA256 string `json:"sha256"`
|
||||
} `json:"sections"`
|
||||
}
|
||||
if err := json.Unmarshal(original["config.json"], &root); err != nil || len(root.Sections) != 4 {
|
||||
return errors.New("仅支持已完成分区的五文件配置")
|
||||
}
|
||||
for _, name := range names[:4] {
|
||||
reference := root.Sections[name[:len(name)-5]]
|
||||
if reference.File != name || reference.SHA256 != digest(original[name]) {
|
||||
return fmt.Errorf("%s 原有摘要不匹配,未写入", name)
|
||||
}
|
||||
old := []byte(`"sha256": "` + reference.SHA256 + `"`)
|
||||
next := []byte(`"sha256": "` + digest(formatted[name]) + `"`)
|
||||
if bytes.Count(formatted["config.json"], old) != 1 {
|
||||
return errors.New("根配置摘要位置不唯一,未写入")
|
||||
}
|
||||
formatted["config.json"] = bytes.Replace(formatted["config.json"], old, next, 1)
|
||||
}
|
||||
changed := false
|
||||
for _, name := range names {
|
||||
changed = changed || !bytes.Equal(original[name], formatted[name])
|
||||
}
|
||||
if !*apply || !changed {
|
||||
fmt.Printf("检查通过:五个 JSON 可读取,是否需要排版:%t。\n", changed)
|
||||
return nil
|
||||
}
|
||||
// 备份目录必须不存在,拒绝覆盖之前的备份。
|
||||
if err := os.Mkdir(*backup, 0700); err != nil {
|
||||
return errors.New("无法创建独立备份目录,未改写配置")
|
||||
}
|
||||
for _, name := range names {
|
||||
if err := atomicfile.Write(filepath.Join(*backup, name), original[name], 0600); err != nil {
|
||||
return errors.New("备份未完成,未改写配置")
|
||||
}
|
||||
}
|
||||
for _, name := range names {
|
||||
data, err := os.ReadFile(filepath.Join(*directory, name))
|
||||
if err != nil || !bytes.Equal(data, original[name]) {
|
||||
return errors.New("备份期间配置发生变化,未改写配置")
|
||||
}
|
||||
}
|
||||
for _, name := range names {
|
||||
if err := atomicfile.Write(filepath.Join(*directory, name), formatted[name], 0600); err != nil {
|
||||
return errors.New("写入未完成,请保持停服并使用本次备份恢复五个文件")
|
||||
}
|
||||
}
|
||||
fmt.Println("五个 JSON 已分行缩进,摘要已同步;配置值、代次及密文未改变。")
|
||||
return nil
|
||||
}
|
||||
|
||||
func digest(data []byte) string {
|
||||
value := sha256.Sum256(data)
|
||||
return hex.EncodeToString(value[:])
|
||||
}
|
||||
@@ -0,0 +1,63 @@
|
||||
import assert from 'node:assert/strict'
|
||||
import { createHash } from 'node:crypto'
|
||||
import { readFileSync, readdirSync, writeFileSync } from 'node:fs'
|
||||
import path from 'node:path'
|
||||
|
||||
const [workspace, evidence] = process.argv.slice(2)
|
||||
if (!workspace || !evidence) throw new Error('请指定项目根目录和本次验证目录')
|
||||
const digest = data => createHash('sha256').update(data).digest('hex')
|
||||
const read = filename => readFileSync(filename, 'utf8')
|
||||
const names = ['config.json', 'smtp.json', 'email.json', 'ssl.json', 'plugins.json']
|
||||
|
||||
// 只忽略字符串外的 JSON 空白,数字精度、中文、转义及字段顺序都必须保持。
|
||||
function compact(raw) {
|
||||
JSON.parse(raw)
|
||||
let quoted = false
|
||||
let escaped = false
|
||||
let result = ''
|
||||
for (const character of raw) {
|
||||
if (quoted) {
|
||||
result += character
|
||||
if (escaped) escaped = false
|
||||
else if (character === '\\') escaped = true
|
||||
else if (character === '"') quoted = false
|
||||
} else if (character === '"') {
|
||||
quoted = true
|
||||
result += character
|
||||
} else if (!' \t\r\n'.includes(character)) result += character
|
||||
}
|
||||
return result
|
||||
}
|
||||
|
||||
const report = { checkedAt: new Date().toISOString(), files: [] }
|
||||
for (const [relative, backup] of [['config', 'root-config'], ['yunx-test/config', 'runtime-config']]) {
|
||||
const directory = path.join(workspace, relative)
|
||||
assert.deepEqual(readdirSync(directory).sort(), [...names].sort(), '配置目录出现额外文件')
|
||||
const oldRoot = JSON.parse(read(path.join(evidence, backup, 'config.json')))
|
||||
const newRoot = JSON.parse(read(path.join(directory, 'config.json')))
|
||||
for (const name of names) {
|
||||
const oldRaw = read(path.join(evidence, backup, name))
|
||||
const newRaw = read(path.join(directory, name))
|
||||
assert(!newRaw.startsWith('\ufeff'), '配置不能含 BOM')
|
||||
assert(newRaw.includes('\n "'), '配置未按两空格缩进分行')
|
||||
let expected = compact(oldRaw)
|
||||
if (name === 'config.json') {
|
||||
for (const [section, reference] of Object.entries(oldRoot.sections)) {
|
||||
expected = expected.replace(`"sha256":"${reference.sha256}"`, `"sha256":"${newRoot.sections[section].sha256}"`)
|
||||
}
|
||||
} else {
|
||||
const section = name.slice(0, -5)
|
||||
assert.equal(newRoot.sections[section].sha256, digest(Buffer.from(newRaw)), '新文件摘要不匹配')
|
||||
}
|
||||
// 不输出配置原文或断言两侧内容,避免凭据进入测试日志。
|
||||
assert(expected === compact(newRaw), `${relative}/${name} 内容发生变化`)
|
||||
report.files.push({ file: `${relative}/${name}`, lines: newRaw.split('\n').length, valuesUnchanged: true })
|
||||
}
|
||||
}
|
||||
const before = JSON.parse(read(path.join(evidence, 'before.json')).replace(/^\ufeff/, ''))
|
||||
const audit = readFileSync(path.join(workspace, 'yunx-test/log/config-audit-v2.jsonl'))
|
||||
report.auditUnchanged = digest(audit).toUpperCase() === before.auditSHA256
|
||||
assert(report.auditUnchanged, '审计原始文件发生变化')
|
||||
writeFileSync(path.join(evidence, 'verification.json'), JSON.stringify(report, null, 2) + '\n')
|
||||
console.log('验证通过:10 个 JSON 仅变更空白和对应摘要;中文、密文、数字、版本及审计原字节保持不变。')
|
||||
for (const file of report.files) console.log(`${file.file}:${file.lines} 行`)
|
||||
Reference in new issue
Block a user