【免費(fèi)下載鏈接】tailcatlike netcat, but over Tailscales data plane, without Tailscales control plane項(xiàng)目地址https://gitcode.com/GitHub_Trending/ta/tailcat點(diǎn)擊查看免費(fèi)下載本文是 tailcat基于 Tailscale 數(shù)據(jù)面、無需控制面的 netcat 風(fēng)格工具的版本發(fā)布Release操作手冊(cè)。核心內(nèi)容以倉庫根目錄的 RELEASING.md 為骨架并結(jié)合倉庫中的 tag.sh、.goreleaser.yaml、Dockerfile.goreleaser 與 .github/workflows/release.yml 等真實(shí)配置展開。讀完本文你將掌握如何用./tag.sh打一個(gè) SSH 簽名的帶注釋標(biāo)簽、推標(biāo)簽后 GitHub Actions 如何觸發(fā) GoReleaser 構(gòu)建產(chǎn)物、發(fā)布包含哪些平臺(tái)工件與容器鏡像、tailcat version的版本號(hào)從哪里來以及如何在本地用goreleaser release --snapshot做不發(fā)布的全量試構(gòu)建。一、整體發(fā)布模型推 Tag 即發(fā)布tailcat 的發(fā)布模型非常簡(jiǎn)潔發(fā)布 推送一個(gè)版本標(biāo)簽。不需要手工登錄任何發(fā)布平臺(tái)也不需要本地機(jī)器執(zhí)行構(gòu)建——構(gòu)建與發(fā)布全部由托管在 GitHub Actions 上的 Release 工作流.github/workflows/release.yml完成。工作流的觸發(fā)條件是推送任意v*格式的標(biāo)簽見 .github/workflows/release.yml 中的on: push: tags: [v*]。觸發(fā)后工作流會(huì)按以下步驟執(zhí)行檢出代碼fetch-depth: 0即完整克隆歷史用于生成 changelog安裝與go.mod匹配的 Go 工具鏈用docker/setup-buildx-action準(zhǔn)備 buildx 構(gòu)建器多架構(gòu)容器鏡像需要docker-container驅(qū)動(dòng)登錄ghcr.io容器倉庫運(yùn)行 GoReleaser版本~ v2執(zhí)行g(shù)oreleaser release --clean使用的配置是倉庫根目錄的.goreleaser.yaml。GoReleaser 在 CI 中完成全部工作編譯各平臺(tái)二進(jìn)制、打包歸檔、生成.deb/.rpm、構(gòu)建并推送容器鏡像、生成校驗(yàn)和文件最終創(chuàng)建一個(gè) GitHub Release 草稿draftchangelog 由提交日志自動(dòng)生成。草稿對(duì)關(guān)注者watchers不可見直到發(fā)布者手動(dòng)編輯并發(fā)布。這一設(shè)計(jì)的關(guān)鍵點(diǎn)是 .goreleaser.yaml 中的release.draft: true發(fā)布動(dòng)作publish才是通知關(guān)注者的那一步因此發(fā)布通知里攜帶的是人工整理過的發(fā)布說明而不是機(jī)器生成的提交日志。工作流權(quán)限contents: write允許創(chuàng)建草稿 Releasepackages: write允許向ghcr.io推送容器鏡像。二、打標(biāo)簽運(yùn)行 ./tag.sh發(fā)布的第一步是在本地打一個(gè)帶注釋的、SSH 簽名的版本標(biāo)簽。這一步由倉庫根目錄的 tag.sh 腳本完成它會(huì)替你把安全校驗(yàn)都做掉。使用方式./tag.sh v0.1.0腳本接受0.1.0和v0.1.0兩種寫法并統(tǒng)一規(guī)范化為v0.1.0形式。執(zhí)行后腳本不會(huì)推送而是打印出推送命令讓你手動(dòng)執(zhí)行g(shù)it push origin v0.1.0tag.sh 內(nèi)部做了哪些檢查對(duì)照 tag.sh 源碼可以拆解出四個(gè)關(guān)鍵環(huán)節(jié)版本號(hào)格式校驗(yàn)tag.sh版本號(hào)必須匹配vX.Y.Z形式可選后綴-pre這類預(yù)發(fā)布標(biāo)識(shí)正則^[0-9]\.[0-9]\.[0-9](-[0-9A-Za-z.-])?$否則腳本直接報(bào)錯(cuò)退出。SSH 簽名密鑰檢查tag.sh腳本要求 git 配置了user.signingkey且指向你的 SSH 公鑰。若未配置會(huì)提示你執(zhí)行g(shù)it config --global user.signingkey ~/.ssh/id_ed25519.pub也就是說tailcat 使用SSH 簽名gpg.formatssh而不是傳統(tǒng)的 OpenPGP 來簽署發(fā)布標(biāo)簽。以 origin 為唯一事實(shí)來源檢查標(biāo)簽是否已存在tag.sh腳本通過git ls-remote --tags origin refs/tags/$tag直接查詢遠(yuǎn)端而不是信任本地可能過期的引用。只要遠(yuǎn)端已存在同名標(biāo)簽?zāi)_本立即失敗防止覆蓋已發(fā)布的版本。本地未推送標(biāo)簽可安全替換tag.sh如果標(biāo)簽只存在于本地從未推送過腳本會(huì)先刪除重建然后執(zhí)行簽名git -c gpg.formatssh tag -s -f -m tailcat $tag $tag-s表示簽名-f表示強(qiáng)制替換-m指定提交信息如tailcat v0.1.0。腳本全程set -euo pipefail任何一步失敗都會(huì)中斷保證不會(huì)留下半成品狀態(tài)。發(fā)布操作清單確認(rèn)main分支的 Test 工作流.github/workflows/test.yml是綠色通過狀態(tài)運(yùn)行./tag.sh vX.Y.Z前提git 已配置 SSHuser.signingkey按腳本提示執(zhí)行g(shù)it push origin vX.Y.Z到 Actions 頁觀察 Release 工作流執(zhí)行工作流結(jié)束后Releases 頁面會(huì)出現(xiàn)包含全部工件的草稿編輯草稿用人工撰寫的發(fā)布說明替換或置于自動(dòng) changelog 之上然后發(fā)布。發(fā)布Publish才是通知關(guān)注者的動(dòng)作。三、發(fā)布包含哪些工件Artifacts二進(jìn)制與安裝包每個(gè) Release 都包含由 .goreleaser.yaml 的 builds 與 nfpms、archives 段決定工件類型平臺(tái)/架構(gòu)格式Linux 靜態(tài)二進(jìn)制amd64、arm64、armv7tar.gzDebian 包上述三種架構(gòu).debRPM 包上述三種架構(gòu).rpmWindows 二進(jìn)制amd64、arm64zip校驗(yàn)和文件以上全部checksums.txtSHA-256編譯細(xì)節(jié)值得展開靜態(tài)編譯構(gòu)建環(huán)境設(shè)置CGO_ENABLED0.goreleaser.yaml產(chǎn)出純靜態(tài)二進(jìn)制這也是容器鏡像可以放心使用 distroless 基鏡像的前提裁剪符號(hào)-s -w剝離符號(hào)表與調(diào)試信息減小體積版本注入-X main.versionv{{ .Version }}.goreleaser.yaml把 GoReleaser 的版本號(hào)直接寫進(jìn)二進(jìn)制構(gòu)建標(biāo)簽裁剪編譯時(shí)傳入一長(zhǎng)串ts_omit_*構(gòu)建標(biāo)簽如ts_omit_dns、ts_omit_serve、ts_omit_health等見 .goreleaser.yaml用于裁剪掉 tailscale 庫中 tailcat 用不到的功能模塊縮小二進(jìn)制體積。配置文件注釋明確要求該標(biāo)簽列表與build-tags.txt和internal/buildtags.ReleaseTags保持同步并用go run ./internal/buildtags/printtags重新生成且由測(cè)試強(qiáng)制校驗(yàn)見 internal/buildtags/buildtags_test.go平臺(tái)矩陣Linux/Windows × amd64/arm64Linux 額外支持 armarmv7但忽略 Windows/arm 組合.goreleaser.yaml歸檔命名tailcat_{{ .Version }}_{{ .Os }}_{{ .Arch }}{{ if .Arm }}v{{ .Arm }}{{ end }}Linux 用 tar.gz、Windows 用 zip并附帶 LICENSE 與 README.md.goreleaser.yaml。.deb/.rpm包的元信息在 nfpms 段定義.goreleaser.yaml包名tailcat、維護(hù)者 Tailscale Inc.、BSD-3-Clause 許可證安裝目錄/usr/bin。容器鏡像每次發(fā)布還會(huì)向ghcr.io/tailscale/tailcat推送amd64 與 arm64 雙架構(gòu)鏡像同時(shí)打vX.Y.Z和latest兩個(gè)標(biāo)簽.goreleaser.yaml。鏡像的構(gòu)建方式很有特點(diǎn)——它不是從源碼構(gòu)建而是復(fù)用 GoReleaser 已經(jīng)編譯好的二進(jìn)制?？?Dockerfile.goreleaserFROM gcr.io/distroless/static-debian12:nonroot ARG TARGETPLATFORM COPY $TARGETPLATFORM/tailcat /usr/local/bin/tailcat ENTRYPOINT [/usr/local/bin/tailcat]幾點(diǎn)值得注意基鏡像是gcr.io/distroless/static-debian12:nonroot。distroless 靜態(tài)基鏡像自帶CA 證書連接 DERP 中繼做 TLS 握手需要和nonroot 用戶可寫的家目錄緩存 DERP 地圖、存放生成的密鑰COPY $TARGETPLATFORM/tailcat說明它依賴構(gòu)建上下文中按平臺(tái)分目錄預(yù)置的二進(jìn)制所以直接從倉庫 checkout 去docker build是行不通的——Dockerfile 頭部的注釋明確說明了這一點(diǎn)容器內(nèi)的狀態(tài)全部位于 nonroot 用戶的家目錄身份密鑰在~/.config/tailcat緩存的 DERP 地圖在~/.cache/tailcat。要跨運(yùn)行持久化可以掛載卷docker run -v tailcat-state:/home/nonroot ghcr.io/tailscale/tailcat新建的命名卷會(huì)自動(dòng)繼承 nonroot 所有權(quán)。另一種方式是用--key直接指定容器內(nèi)任意位置掛載進(jìn)來的密鑰文件路徑。鏡像還帶有完整的 OCI 標(biāo)簽org.opencontainers.image.title/source/version/revision/licenses其中 revision 取自{{ .FullCommit }}方便追溯鏡像對(duì)應(yīng)的源碼提交。四、版本號(hào)從哪里來tailcat version 的雙通道邏輯發(fā)布版二進(jìn)制中嵌入的版本號(hào)來自 GoReleaser 的-ldflags -X main.version...注入.goreleaser.yaml。在源碼側(cè)對(duì)應(yīng)的實(shí)現(xiàn)是 cmd/tailcat/tailcat.go// version is set via -ldflags by GoReleaser at release time. // It is empty for go-install and plain go-build builds. var version string // versionString returns the version set at release build time, // falling back to the module version from the Go build info. func versionString() string { if version ! { return version } if bi, ok : debug.ReadBuildInfo(); ok bi.Main.Version ! { return bi.Main.Version } return unknown }邏輯分兩層發(fā)布版GoReleaser 注入的main.version非空tailcat version直接打印它自編譯版如果用go install github.com/tailscale/tailcat/cmd/tailcatvX.Y.Z安裝-ldflags注入為空此時(shí)回退到debug.ReadBuildInfo()讀取Go build info 中的模塊版本即后面的版本本地go build且不帶模塊版本時(shí)最終回退為unknown。另外值得注意tailcat version子命令是官方入口cmd/tailcat/tailcat.go但同時(shí)保留了tailcat --version這個(gè)未廣告的別名——--version并不是注冊(cè)過的 flag而是 main 在命令行解析失敗時(shí)做的特判cmd/tailcat/tailcat.go目的是兼容 nixpkgs 的versionCheckHook見 cmd/tailcat/e2e_test.go 的說明與測(cè)試。五、本地試構(gòu)建goreleaser release --snapshot發(fā)布前想在本地完整驗(yàn)證一遍構(gòu)建、不打標(biāo)簽也不推送任何東西安裝 GoReleaser 后執(zhí)行g(shù)oreleaser release --snapshot --clean--snapshot快照模式版本號(hào)帶-SNAPSHOT-后綴不推送任何遠(yuǎn)程產(chǎn)物不創(chuàng)建 Release、不推容器鏡像--clean開始前清空dist/目錄。工件全部落在dist/該目錄在.gitignore中不會(huì)污染倉庫?？煺漳Ｊ脚c真實(shí)發(fā)布的差異快照模式下有兩個(gè)與容器鏡像相關(guān)的行為差異需要提前知曉見 RELEASING.md不打多架構(gòu) manifest容器鏡像以每個(gè)平臺(tái)一個(gè)獨(dú)立 tag的方式構(gòu)建進(jìn)本地 Docker daemon如tailcat:linux_amd64、tailcat:linux_arm64而不是合并成一個(gè) multi-arch manifest也不會(huì)推送到 ghcr.io需要 buildx 的 docker-container 驅(qū)動(dòng)構(gòu)建鏡像依賴該驅(qū)動(dòng)先執(zhí)行docker buildx create --use創(chuàng)建即可。關(guān)于 .gitignore 與構(gòu)建一致性.gitignore 將dist/排除在版本控制之外本地試構(gòu)建不會(huì)污染提交由于快照模式版本號(hào)帶-SNAPSHOT-后綴恰好可以用來驗(yàn)證-X main.versionv{{ .Version }}的注入鏈路是否工作dist/里生成的二進(jìn)制執(zhí)行tailcat version應(yīng)能看到快照版本。六、端到端流程回顧與排錯(cuò)要點(diǎn)把整條鏈路串起來看./tag.sh v0.1.0 └─ 校驗(yàn)版本格式 → 校驗(yàn) SSH signingkey → 查詢 origin 防重復(fù) → 打 SSH 簽名帶注釋標(biāo)簽 git push origin v0.1.0 └─ 觸發(fā) .github/workflows/release.ymltags: v* └─ setup-go版本取自 go.mod→ setup-buildx → 登錄 ghcr.io └─ goreleaser release --clean配置 .goreleaser.yaml ├─ 編譯 linux/windows × amd64/arm64(/armv7) 靜態(tài)二進(jìn)制 ├─ 打包 tar.gz/zip、deb/rpm ├─ 構(gòu)建并推送 amd64arm64 容器鏡像vX.Y.Z latest ├─ 生成 checksums.txt └─ 創(chuàng)建草稿 Releasedraft: true 發(fā)布者編輯草稿 → Publish通知關(guān)注者常見坑位對(duì)照現(xiàn)象原因處理tag.sh報(bào)user.signingkey is not setgit 未配置 SSH 簽名密鑰git config --global user.signingkey ~/.ssh/id_ed25519.pubtag.sh報(bào) tag 已存在于 origin版本重復(fù)發(fā)布換新版本號(hào)不要覆蓋已發(fā)布的 tag本地 tag 可被替換該 tag 從未推送過腳本自動(dòng)-f重建無需干預(yù)本地快照構(gòu)建容器鏡像失敗缺少 buildx docker-container 驅(qū)動(dòng)docker buildx create --usetailcat version打印 unknown本地go build無任何版本信息用go install ...vX.Y.Z或走 GoReleaser 構(gòu)建tailcat --version也能用nixpkgs 兼容別名官方入口是tailcat version子命令七、相關(guān)文件索引發(fā)布鏈路涉及的關(guān)鍵倉庫文件均以倉庫根目錄為起點(diǎn)RELEASING.md本文的骨架文檔官方發(fā)布流程說明tag.sh本地打 SSH 簽名標(biāo)簽的腳本.goreleaser.yamlGoReleaser v2 配置定義構(gòu)建矩陣、歸檔、deb/rpm、容器鏡像、校驗(yàn)和與草稿 ReleaseDockerfile.goreleaser容器鏡像 Dockerfile基于 distroless復(fù)用預(yù)編譯二進(jìn)制.github/workflows/release.ymlRelease 工作流tags: v*觸發(fā).github/workflows/test.yml發(fā)布前需保證綠色的 Test 工作流cmd/tailcat/tailcat.gomain.version變量與versionString()雙通道回退邏輯internal/buildtags/buildtags_test.go強(qiáng)制構(gòu)建標(biāo)簽列表與 GoReleaser 配置同步的測(cè)試cmd/tailcat/e2e_test.go--version兼容別名的端到端測(cè)試。需要說明的是本文介紹的流程以當(dāng)前倉庫實(shí)際內(nèi)容為準(zhǔn)標(biāo)簽觸發(fā)式發(fā)布、SSH 簽名、GoReleaser v2 配置、draft 發(fā)布模型以及 distroless 容器鏡像均可在上述倉庫文件中逐一核對(duì)。實(shí)際操作時(shí)請(qǐng)以倉庫當(dāng)前版本的 RELEASING.md 為準(zhǔn)注意版本號(hào)、tag 列表與配置文件的同步性。贊分享【免費(fèi)下載鏈接】tailcatlike netcat, but over Tailscales data plane, without Tailscales control plane項(xiàng)目地址https://gitcode.com/GitHub_Trending/ta/tailcat點(diǎn)擊查看免費(fèi)下載相關(guān)推薦chezmoi 發(fā)布流程全解析從 GoReleaser 測(cè)試構(gòu)建到 cosign 簽名的自動(dòng)化發(fā)布管線chezmoi 發(fā)布流程全解析從 GoReleaser 測(cè)試構(gòu)建到 cosign 簽名的自動(dòng)化發(fā)布管線 本文以 chezmoi 官方開發(fā)者文檔 release開發(fā)工具CLI配置管理Bitcoin 倉庫 libsecp256k1 發(fā)布流程完全指南從 Sanity Checks 到 tag 與歸檔簽名發(fā)布Bitcoin 倉庫 libsecp256k1 發(fā)布流程完全指南從 Sanity Checks 到 tag 與歸檔簽名發(fā)布 本指南以 Bitcoin Core區(qū)塊鏈金融科技網(wǎng)絡(luò)密碼學(xué)fiftyone-db 發(fā)布全流程指南從 GitHub Release 標(biāo)簽到 PyPI 自動(dòng)構(gòu)建發(fā)布fiftyone db 發(fā)布全流程指南從 GitHub Release 標(biāo)簽到 PyPI 自動(dòng)構(gòu)建發(fā)布 fiftyone db 是 FiftyOne http人工智能計(jì)算機(jī)視覺數(shù)據(jù)集數(shù)據(jù)可視化數(shù)據(jù)標(biāo)注模型評(píng)測(cè)上一篇Selene 源碼解析深入理解 Python 瀏覽器測(cè)試框架的設(shè)計(jì)原理下一篇Depressurizer核心功能解析從自動(dòng)分類到高級(jí)篩選的終極指南創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考