feat(release): one-command desktop release with Ed25519-signed update metadata

The installer is unsigned, so latest.yml is now signed with an Ed25519 key and the
app verifies the downloaded installer against it before installing.
npm run release -- patch|minor bumps, gates, tags, builds, signs, publishes,
re-verifies the public feed and pushes; --resume continues after a failure.
The retired GitLab registry publisher is removed.
This commit is contained in:
Yun Chan 2026-10-18 07:06:55 +09:00
parent f5ae4c8c04
commit fd9c97b7cc
21 changed files with 986 additions and 144 deletions

View file

@ -8,7 +8,8 @@ import { app, dialog } from 'electron'
import { getLogger } from './LoggerService'
import { configGet } from './ConfigService'
import { getMainWindow } from '../windows/WindowManager'
import { UPDATE_FEED_URL, UPDATE_POLICY_URL } from '../update-feed'
import { UPDATE_FEED_URL, UPDATE_POLICY_URL, versionedManifestUrl } from '../update-feed'
import { verifyDownloadedUpdate } from '../update-signature'
import { DEFAULT_UPDATE_POLICY, parseUpdatePolicy, type UpdatePolicy } from '../update-policy'
import { PORTABLE_INSTALL_MARKER, detectInstallKind, type InstallProbe } from '../install-kind'
import type {
@ -24,6 +25,41 @@ const logger = getLogger('UpdateService')
/** 원격 정책 fetch 타임아웃 */
const POLICY_FETCH_TIMEOUT_MS = 8_000
/** 서명된 latest.yml fetch 타임아웃 */
const MANIFEST_FETCH_TIMEOUT_MS = 15_000
async function fetchText(url: string): Promise<string> {
const response = await fetch(url, { cache: 'no-store', signal: AbortSignal.timeout(MANIFEST_FETCH_TIMEOUT_MS) })
if (!response.ok) throw new Error(`HTTP ${response.status} ${url}`)
return response.text()
}
/**
* NsisUpdater 는 받은 파일을 넘기기 전에 `verifySignature(path)` 를 부르고, 문자열을 돌려받으면
* 파일을 지우고 ERR_UPDATER_INVALID_SIGNATURE 로 실패한다. 무서명 앱에선 이 단계가 아무것도 안 하므로
* 우리 Ed25519 검증으로 바꿔 끼운다. 라이브러리가 이 지점을 없애면 업데이트를 받지 않는다(fail-closed).
*/
function installManifestVerifier(
updater: import('electron-updater').AppUpdater,
offeredVersion: () => string | null,
): boolean {
const target = updater as unknown as { verifySignature?: (path: string) => Promise<string | null> }
if (typeof target.verifySignature !== 'function') return false
target.verifySignature = async (installerPath: string): Promise<string | null> => {
const version = offeredVersion()
if (!version) return '받으려던 버전을 알 수 없음'
const rejection = await verifyDownloadedUpdate({
version,
installerPath,
fetchText,
manifestUrl: versionedManifestUrl(version),
})
if (rejection) logger.error(`업데이트 v${version} 설치 거부 — ${rejection}`)
else logger.info(`업데이트 v${version} 서명 확인 완료`)
return rejection
}
return true
}
/** 실행 중인 설치본의 형태를 파일 시스템에서 읽는다 (판단은 detectInstallKind). */
function probeInstall(): InstallProbe {
@ -74,6 +110,13 @@ export function createElectronUpdater(handlers: UpdaterEventHandlers): UpdaterPo
return null
}
let offeredVersion: string | null = null
// macOS 는 Squirrel.Mac 이 앱 코드 서명을 직접 요구하므로 이 검증은 Windows(NSIS) 전용이다.
if (process.platform === 'win32' && !installManifestVerifier(updater, () => offeredVersion)) {
logger.error('electron-updater 에 설치 파일 검증 지점(verifySignature)이 없음 — 자동 업데이트 비활성')
return null
}
updater.setFeedURL({ provider: 'generic', url: UPDATE_FEED_URL })
// 사용자 인가를 위해 자동 다운로드는 비활성화 (동의 시 downloadUpdate 호출)
updater.autoDownload = false
@ -87,7 +130,10 @@ export function createElectronUpdater(handlers: UpdaterEventHandlers): UpdaterPo
}
updater.on('checking-for-update', () => handlers.onChecking())
updater.on('update-available', (info) => handlers.onAvailable(info))
updater.on('update-available', (info) => {
offeredVersion = info.version
handlers.onAvailable(info)
})
updater.on('update-not-available', (info) => handlers.onNotAvailable(info.version))
updater.on('download-progress', (progress) =>
handlers.onProgress({

View file

@ -24,11 +24,13 @@ export const RUNTIME_FEED_URL = UPDATE_FEED_URL.replace(/\/latest$/, '/runtime-l
/** 런타임 인덱스 파일명 (feed 루트) — RuntimeProvisioner 가 `${RUNTIME_FEED_URL}/${RUNTIME_INDEX_FILENAME}` 으로 읽는다 */
export const RUNTIME_INDEX_FILENAME = 'runtime.json'
// GitLab Generic Registry legacy mirror. 2026-08 이전 설치본(0.2.1-alpha)은
// 이 feed를 폴링하므로, 새 설치자가 Forgejo feed를 내장할 때까지 publisher가
// 함께 게시한다. 마이그레이션 완료 후 제거 가능. 런타임은 참조하지 않는다.
export const LEGACY_UPDATE_FEED_URL =
'https://gitlab.twentyoz.kr:8443/api/v4/projects/1172/packages/generic/d3ro-voice/latest'
/**
* 버전별(불변) 경로의 latest.yml. 서명 검증은 `latest`(가변) 대신 이 경로를 본다 —
* 받는 사이에 새 버전이 게시돼 latest.yml 이 바뀌어도 검증 대상이 흔들리지 않는다.
*/
export function versionedManifestUrl(version: string): string {
return `${UPDATE_FEED_URL.replace(/\/latest$/, '')}/${encodeURIComponent(version)}/latest.yml`
}
/** 업데이트 채널. `latest`=stable, `beta`, `alpha` 순으로 불안정. */
export type UpdateChannel = 'latest' | 'beta' | 'alpha'

View file

@ -0,0 +1,91 @@
// src/main/update-signature.ts
// 받은 업데이트 설치 파일이 우리가 게시한 것인지 확인한다.
//
// 설치본에 Authenticode 서명이 없어 electron-updater 는 자체 서명 검증을 건너뛴다. 그러면 피드
// (Forgejo 패키지)가 털렸을 때 아무 설치 파일이나 배포된다. 그래서 게시 스크립트가 latest.yml 을
// 오프라인 Ed25519 키로 서명하고(latest.yml.sig), 앱은:
// 1. 버전별(불변) 경로의 latest.yml + .sig 를 받아 내장 공개키로 서명을 확인하고
// 2. 그 latest.yml 의 version · sha512 가 받은 설치 파일과 같은지 본다.
// 하나라도 어긋나면 설치를 거부한다(fail-closed). 게시 쪽: scripts/ci/lib/update-manifest-signature.mjs
import { createHash, createPublicKey, verify } from 'node:crypto'
import { createReadStream } from 'node:fs'
/** release/desktop-update-public.pem 사본 — verify-release-metadata 가 둘이 같은지 검사한다 */
export const UPDATE_SIGNING_PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
MCowBQYDK2VwAyEAlvJTkVr7CSi9ZbBL2JOub7Sw4CAc1WOJpLEjDs/V/8o=
-----END PUBLIC KEY-----
`
export const UPDATE_SIGNATURE_SUFFIX = '.sig'
const ED25519_SIGNATURE_BYTES = 64
export interface SignedManifestInput {
manifest: string
signature: string
publicKeyPem?: string
}
/** 서명이 맞으면 latest.yml 의 version/sha512 를, 아니면 null 을 돌려준다 */
export function readSignedManifest({
manifest,
signature,
publicKeyPem = UPDATE_SIGNING_PUBLIC_KEY,
}: SignedManifestInput): { version: string; sha512: string } | null {
const signatureBytes = Buffer.from(signature.trim(), 'base64')
if (signatureBytes.length !== ED25519_SIGNATURE_BYTES) return null
let valid = false
try {
valid = verify(null, Buffer.from(manifest, 'utf8'), createPublicKey(publicKeyPem), signatureBytes)
} catch {
return null
}
if (!valid) return null
// 서명된 내용이라 신뢰할 수 있다 — 최상위 키만 읽으면 된다(files[] 아래 들여쓴 줄은 제외).
const version = manifest.match(/^version:\s*['"]?([^'"\s]+)['"]?\s*$/m)?.[1]
const sha512 = manifest.match(/^sha512:\s*['"]?([^'"\s]+)['"]?\s*$/m)?.[1]
return version && sha512 ? { version, sha512 } : null
}
export function sha512Base64OfFile(path: string): Promise<string> {
return new Promise((resolve, reject) => {
const hash = createHash('sha512')
createReadStream(path)
.on('data', (chunk) => hash.update(chunk))
.on('end', () => resolve(hash.digest('base64')))
.on('error', reject)
})
}
export interface VerifyDownloadInput {
/** 사용자에게 제안했던(받으려던) 버전 */
version: string
installerPath: string
fetchText(url: string): Promise<string>
manifestUrl: string
publicKeyPem?: string
hashFile?: (path: string) => Promise<string>
}
/** 통과하면 null, 거부하면 사유 문자열 (electron-updater verifySignature 계약과 같다) */
export async function verifyDownloadedUpdate(input: VerifyDownloadInput): Promise<string | null> {
let manifest: string
let signature: string
try {
;[manifest, signature] = await Promise.all([
input.fetchText(input.manifestUrl),
input.fetchText(`${input.manifestUrl}${UPDATE_SIGNATURE_SUFFIX}`),
])
} catch (err) {
return `서명된 업데이트 메타데이터를 받지 못함: ${err instanceof Error ? err.message : String(err)}`
}
const signed = readSignedManifest({ manifest, signature, publicKeyPem: input.publicKeyPem })
if (!signed) return 'latest.yml 서명이 유효하지 않음'
if (signed.version !== input.version) {
return `서명된 버전(${signed.version})이 받은 버전(${input.version})과 다름`
}
const actual = await (input.hashFile ?? sha512Base64OfFile)(input.installerPath)
if (actual !== signed.sha512) return '설치 파일 sha512 가 서명된 latest.yml 과 다름'
return null
}