gcopy

v2.0.2

🚀 Highlights / 重要更新

This release includes a major refactoring since v1.6.0, along with several CI/CD and bug fixes.
本版本包含自 v1.6.0 以来的重大重构，以及多项 CI/CD 和 Bug 修复。

📋 Changes since v1.6.0 / v1.6.0 以来的改动

💥 Breaking Change / 重大变更

• Refactor: Embed frontend static assets, runtime i18n, env config, and TLS support / 重构：嵌入前端静态资源、运行时国际化、环境变量配置及TLS支持 (9678490)
  • Frontend build output is now embedded into Go binary via go embed, removing the need for separate Nginx/Supervisor deployment / 使用 go embed 将前端构建产物嵌入 Go binary，移除独立的 Nginx/Supervisor 部署依赖
  • i18n switched from URL-based pre-compiled (/en/, /zh/) to runtime browser language detection / 前端国际化从基于 URL 路径的预编译方案切换为运行时浏览器语言检测
  • Backend config supports GCOPY_ prefixed environment variables, with TLS and app-key length validation / 后端配置支持通过 GCOPY_ 前缀环境变量设置，同时新增 TLS 和 app-key 长度校验
  • Makefile now builds multi-architecture binaries (linux/darwin, amd64/arm64), added frontend-build target / Makefile 改为多架构构建，新增 frontend-build 目标
  • Removed outdated deployment docs and helper scripts / 清理过时的部署文档和辅助脚本

✨ Features / 新功能

• Add make release target for version tagging / 新增 make release 目标用于版本打标 (1496b34)

🐛 Bug Fixes / Bug 修复

• Fix i18n hydration mismatch and initial logs not updating with language / 修复i18n hydration mismatch及初始日志不随语言更新 (09cbe10)
  • i18n.tsx: useState initial locale unified to en, switched to browser language in useEffect / useState初始locale统一为en，useEffect中切换为浏览器语言
  • log.ts: Initial logs moved from useState to useEffect, ensuring locale updates reflect in log content / 初始日志从useState初始值移至useEffect
• Fix Docker multi-stage build failure - use go build directly instead of make / 修复Docker多阶段构建失败，直接调用go build替代make (0eb3e54)
• Fix merge job missing checkout step to read version.txt / 修复merge job缺少checkout步骤以读取version.txt (89b7bad)

⚡ Performance / 性能优化

• Optimize CI build speed - use native ARM runners instead of QEMU emulation / 优化CI构建速度，使用原生ARM runner替代QEMU模拟 (b51da6a)
  • Use ubuntu-24.04-arm native runner for parallel arm64 builds / 使用原生 runner 并行构建 arm64
  • Per-platform build + manifest merge, both platforms execute in parallel / 分平台构建 + manifest 合并
  • Added GitHub Actions Docker layer cache (type=gha, mode=max) / 添加 Docker 层缓存
  • Dockerfile optimization: golang:1-alpine replaces golang, merged RUN layers / Dockerfile 优化

🔧 Chore / 杂项

• Upgrade GitHub Actions to Node.js 24 compatible versions / 升级 GitHub Actions 到兼容 Node.js 24 的版本 (d134779)
• Disable provenance to avoid auto-uploaded dockerbuild artifacts / 禁用 provenance 以避免自动上传 dockerbuild 产物 (85fee83)
• Fix server.go indentation / 修复server.go缩进 (8549a1a)

🐳 Docker Images / Docker 镜像

Docker Hub:

docker pull llaoj/gcopy:v2.0.2
docker pull llaoj/gcopy:latest

Aliyun ACR / 阿里云容器镜像服务:

docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy:v2.0.2
docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy:latest

📦 Binary Downloads / 二进制下载

Full Changelog: https://github.com/llaoj/gcopy/compare/v1.6.0...v2.0.2

🎯 Release Highlights

This release represents a major architectural improvement for GCopy's deployment experience. We've consolidated the frontend and backend into a single Docker image, significantly simplifying deployment and reducing operational complexity. Previously, users needed to manage and coordinate two separate containers; now, everything runs seamlessly in one container using supervisord for process management.

The new architecture includes robust health checks and improved signal handling, ensuring more reliable startup and graceful shutdowns. These changes make GCopy easier to deploy in various environments while maintaining the same functionality you're used to.

What's Changed

♻️ Major Architectural Improvement

Consolidated Docker Image: Merged frontend and backend into a single Docker image, eliminating the need for separate containers. This change:

• Simplifies deployment configuration (one image, one container)
• Reduces network complexity (no inter-container communication)
• Makes it easier to deploy GCopy in constrained environments
• Uses supervisord for reliable process management

🐛 Bug Fixes & Reliability Improvements

Backend Health Check: Added curl to the Docker image and implemented health checks to ensure the backend is ready before starting the frontend, preventing race conditions during container startup.

Signal Handling: Improved supervisord signal handling and logging for proper graceful shutdowns when containers are stopped or restarted.

BusyBox Compatibility: Removed the unsupported -u flag from sed commands, ensuring compatibility with Alpine/BusyBox environments commonly used in minimal Docker images.

Build Simplification: Removed the separate start-frontend.sh script, streamlining the Docker build process.

🔧 Maintenance

Version Bump: Updated version to v1.6.0 to reflect the architectural changes.

🙏 Contributors

Thanks to our contributor for this release:

• 老J (@llaoj)

🐳 Docker Images

Docker Hub

docker pull llaoj/gcopy:v1.6.0
docker pull llaoj/gcopy:latest

Aliyun ACR (China)

docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy:v1.6.0
docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy:latest

🎯 Release Highlights

This release focuses on sustainability and improved user experience. We've added support links to help maintain the project, enhanced QR code login convenience, and introduced configuration options for better control over clipboard content size limits. Documentation has been significantly improved to make deployment and configuration easier for all users.

What's Changed

✨ New Features

Sponsor Support Integration

• Added sponsor support links in README and navigation menu
• Users can now easily access GitHub Star and donation links from the navbar menu (⭐ Give a Star, 💰 Sponsor)
• Enhanced sponsor.md with detailed information about server costs and funding needs
• Support both Chinese and English localization for sponsor messages

Enhanced QR Code Login

• Added copy link button for QR code login page
• Users can now easily share login links across devices with a single click
• Improves the login experience when scanning QR codes on different devices

Configurable Content Size Limits

• Introduced max-content-length parameter to docker-compose.yml
• Administrators can now control the maximum clipboard content size based on their server resources
• Prevents server overload from large file uploads

📝 Documentation

Deployment Documentation Improvements

• Added smtp-ssl parameter examples to email authentication documentation
• Updated all deployment documents with max-content-length parameter explanations
• Fixed Docker deployment configuration to use command flags instead of environment variables
• Improved clarity for new users deploying GCopy

🔧 Maintenance

• Version bump from v1.5.3 to v1.5.5

🙏 Contributors

Thanks to the contributor who made this release possible:

• 老J (@llaoj)

🐳 Docker Images

Docker Hub

GCopy Backend:

docker pull llaoj/gcopy:v1.5.5
docker pull llaoj/gcopy:latest

GCopy Frontend:

docker pull llaoj/gcopy-frontend:v1.5.5
docker pull llaoj/gcopy-frontend:latest

Aliyun ACR (China)

GCopy Backend:

docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy:v1.5.5
docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy:latest

GCopy Frontend:

docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy-frontend:v1.5.5
docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy-frontend:latest

🎯 Release Highlights

This release introduces QR Code Login, making it incredibly easy to log in on new devices by simply scanning a QR code from an already authenticated device. No more typing verification codes or tokens manually!

Additionally, this release includes several important bug fixes for mobile users and iOS Safari compatibility, ensuring a smoother experience across all platforms.

What's Changed

✨ New Features

QR Code Scan for Auto-Fill Login Credentials

• Added QR code generation in the user avatar dropdown menu
• Scan the QR code to automatically fill in login credentials on another device
• Token login page now supports URL parameter auto-fill via QR code scan
• Email login page automatically fills email address from URL parameter
• Separated inputToken and generatedToken states for better state management clarity
• Added qrcode.react dependency for QR code generation

This feature significantly improves the user experience when logging in on multiple devices, eliminating the need to manually copy and paste tokens or email addresses.

🐛 Bug Fixes

File Link Management

• Fixed an issue where file links would persist when switching to text or screenshot sync
• File input now properly resets when syncing text or screenshots, preventing confusion

iOS Safari Compatibility

• Fixed file download behavior in iOS Safari
• Files now download directly instead of attempting to render in the browser
• This resolves issues with certain file types that couldn't be downloaded properly on iOS

Mobile Login Experience

• Added horizontal padding to login pages on mobile devices
• Improved visual appearance and usability on small screens
• Better touch target spacing for mobile users

QR Code Login Navigation

• Fixed navigation issue when scanning QR code for email login
• Users now stay on the email input page after scanning, allowing them to proceed with verification
• Prevented unintended redirects that could interrupt the login flow

🔧 Maintenance

Version Management

• Bumped version to v1.5.3
• Synchronized version across version.txt, package.json, and package-lock.json

🙏 Contributors

Thanks to the contributor who made this release possible:

• @llaoj (老J)

🐳 Docker Images

Docker Hub

GCopy Backend:

docker pull llaoj/gcopy:v1.5.3
docker pull llaoj/gcopy:latest

GCopy Frontend:

docker pull llaoj/gcopy-frontend:v1.5.3
docker pull llaoj/gcopy-frontend:latest

Aliyun ACR (China)

GCopy Backend:

docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy:v1.5.3
docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy:latest

GCopy Frontend:

docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy-frontend:v1.5.3
docker pull registry.cn-beijing.aliyuncs.com/llaoj/gcopy-frontend:latest