What is GO?
What is GO?
GO Shortener is a high-performance, ultra-lightweight, and fully self-contained public URL shortening service built in pure Go. Engineered specifically for resource-constrained environments—such as a small 1 GB RAM Ubuntu VPS hosting multiple services concurrently—GO compiles into a single standalone binary with zero external runtime dependencies.
Core Philosophy
"Simple to use for normal visitors, powerful for registered users, and controllable by administrators."
GO eschews bloat, complex microservices, container orchestrators, and heavyweight database engines in favor of simplicity, reliability, and security:
- Zero External Dependencies: No Docker daemon required, no Node.js runtime, no external Redis instances, and no system C library dependencies.
- Zero-Compile Deployment: The production server never compiles code. Multi-architecture release binaries (
linux/amd64andlinux/arm64) are built and verified automatically in the cloud via GitHub Actions. - Privacy by Design: Visitor IP addresses are hashed using SHA-256 with an identity salt prior to analytics aggregation. Raw IPs are never written to the SQLite database.
- Self-Contained Embedded Frontend: HTML templates, CSS styles, client-side scripts, and assets are embedded directly into the Go executable via Go's native
embed.FS.
Why No Custom Aliases?
Unlike traditional URL shorteners that let visitors choose vanity aliases (such as go.arcn.online/my-brand), GO strictly issues cryptographically random, collision-resistant identifiers (e.g., go.arcn.online/K8xP2q).
Rationale:
- Prevent Vanity Squatting: Disallows malicious users or bots from hoarding common keywords, company names, or popular terms.
- Phishing & Impersonation Mitigation: Eliminates deceptive links designed to spoof legitimate services (e.g.,
go.arcn.online/paypal-login). - Uniform Database Distribution: Short codes are generated using cryptographically secure random bytes mapped to a URL-safe character set, ensuring uniform index distribution in SQLite.
Architecture at a Glance
| Component | Technology | Description |
|---|---|---|
| Language & Runtime | Go 1.22+ | Compiled to native machine code; sub-millisecond route handling |
| Database | modernc.org/sqlite | Pure Go, CGO-free SQLite running with Write-Ahead Logging (WAL) |
| Frontend | Pure HTML/JS (embed.FS) | Statically compiled inside the binary; zero disk reads in production |
| Authentication | Dual-Engine | Native Email/Password (bcrypt cost 12) + Google OAuth via Firebase |
| Edge & Ingress | Cloudflare Tunnel | Exposes local port 3000 securely via cloudflared without open VPS ports |
| Process Manager | Linux systemd | Automatic restarts, boot execution, and resource limits |
Next Steps
- Explore the complete Features Matrix.
- Follow the Installation Guide to install GO on your server.
- Review the Architecture Documentation for internal engineering details.