English
Skip to content
Fishfinal's Blog
Notes on Golang Engineering Practices from Front-Line Development
Focus on solving real problems in backend architecture, database tuning, and automated operations. The content is based on Go (Gin/GORM), PostgreSQL/Redis, Nuxt/VitePress, and GitHub Actions, providing a large number of reusable code snippets and complete troubleshooting approaches.
Growing towards the sun
How to Cross-Compile the MinIO Binary and Deploy It on LinuxSolve GLIBC dependency errors on older systems like CentOS 7 and the issue of official download links returning 410: statically compile the MinIO source code with Go to produce a binary that does not depend on host system libraries, and configure systemd to enable deployment across distributions. Growing towards the sun
Quickly Build a Lightweight K3s Cluster on macOS with ColimaUsing the Colima command line, spin up a native lightweight K3s cluster on macOS with one command. Includes tips to avoid pitfalls when installing kubectl as a prerequisite, startup log analysis, core image explanations, and real-world performance testing on older Macs. Growing towards the sun
VitePress Blog Instant Indexing: Bing IndexNow + GitHub Actions Automation in PracticeSay goodbye to long waits. An IndexNow indexing guide built specifically for VitePress developers. Use GitHub Actions to watch Git commits, automatically extract newly added Markdown, and push it to Bing — closing the loop so articles get indexed the moment they are published. Growing towards the sun
The Ultimate Way to Replace Docker Desktop on macOS: A Complete Guide to Colima + Proxy ConfigurationSay goodbye to Docker Desktop licensing restrictions. Replace it with the open-source, lightweight Colima, and thoroughly solve proxy passthrough and DNS resolution issues for Docker inside macOS virtual machines. Growing towards the sun
Golang Makefile Standardization Tutorial: Best-Practice Template for Auto-Generating helpScattered Makefile targets, missing comments, newcomers left guessing? This tutorial starts from directory structure, target planning, and comment conventions, then uses awk to auto-generate help documentation for `make help`. Includes a complete, directly reusable Makefile template covering build/test/vet and other common targets. Growing towards the sun
Pitfall Log: Go Compilation Error "cannot find module" in an Isolated Intranet Without Internet AccessFixing the `-mod=vendor` compilation error in Go projects running in an isolated intranet/no-internet environment, caused by incomplete IDE file syncing and the presence of a vendor directory. Also offers tips for avoiding pitfalls in offline development. Growing towards the sun
Fixing Dead Links in VitePress: From Script to Root CauseAfter an i18n refactor of a VitePress documentation site, the CI dead link check failed. A complete retrospective: writing a script to automatically capture dead links, investigating a count mismatch caused by a regex miss, pinpointing two root causes — "missing leading slash" and incorrect relative path depth — plus the full script source and run logs. Growing towards the sun
The Ultimate Solution for go:embed Not Supporting Symlinks and Missing Hidden FilesWhile developing a Go scaffolding tool, did files vanish after go:embed packaging and symlinks stop working? This article records the pitfalls encountered and proposes a brand-level solution based on the idea of "dimension reduction and elevation."