{"id":30069509,"url":"https://github.com/xuemian168/kuno","last_synced_at":"2026-05-16T12:02:19.750Z","repository":{"id":306382512,"uuid":"1025487049","full_name":"xuemian168/kuno","owner":"xuemian168","description":"KUNO CMS A full-stack blog application with Go backend and Next.js frontend, containerized with Docker for easy deployment.一个i18n的CMS系统","archived":false,"fork":false,"pushed_at":"2026-05-14T11:50:21.000Z","size":25653,"stargazers_count":74,"open_issues_count":0,"forks_count":10,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-14T12:17:36.066Z","etag":null,"topics":["blog","cms","content-management-system","i18n","llms","markdown","multilingual","nextjs","rag"],"latest_commit_sha":null,"homepage":"https://qut.edu.kg/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xuemian168.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-24T10:24:45.000Z","updated_at":"2026-05-14T11:50:26.000Z","dependencies_parsed_at":"2025-08-02T09:08:20.993Z","dependency_job_id":"7adf6be5-331d-4edd-a6d3-0f4ced886c8f","html_url":"https://github.com/xuemian168/kuno","commit_stats":null,"previous_names":["xuemian168/i18n_blog","xuemian168/echopaper","xuemian168/kuno"],"tags_count":80,"template":false,"template_full_name":null,"purl":"pkg:github/xuemian168/kuno","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuemian168%2Fkuno","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuemian168%2Fkuno/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuemian168%2Fkuno/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuemian168%2Fkuno/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xuemian168","download_url":"https://codeload.github.com/xuemian168/kuno/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xuemian168%2Fkuno/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33102147,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog","cms","content-management-system","i18n","llms","markdown","multilingual","nextjs","rag"],"created_at":"2025-08-08T11:43:32.734Z","updated_at":"2026-05-16T12:02:19.742Z","avatar_url":"https://github.com/xuemian168.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[中文](./README_CN.md) | English\n\n# KUNO\n\n![kuno](./docs/kuno.png)\n\n**KUNO** /ˈkuːnoʊ/ — a lightweight, i18n-first CMS built with Go and Next.js. The name comes from \"坤\" (kūn, earth in the I Ching), meaning to carry and support all things.\n\nA full-stack blog system containerized with Docker for easy deployment.\n\n## Demo\n\n[QUT.EDU.KG](https://qut.edu.kg/)\n\n## Features\n\n- Markdown editor with live preview and Mermaid diagram support\n- 70+ language interface (i18n powered by next-intl)\n- Dark / light theme toggle\n- Responsive, mobile-first layout\n- Category and tag management\n- Admin panel for content management\n- Customizable site title, subtitle, and branding\n- SEO optimization with LLMs.txt support for AI search engines\n- Usage analytics and performance monitoring\n- Docker one-click deployment with blue-green strategy (\u003c 2s downtime)\n- Health checks and automatic rollback on failed deployments\n\n### Supported Languages\n\n| Region | Languages |\n|--------|-----------|\n| Core | Chinese, English |\n| Asian | Japanese, Korean, Thai, Vietnamese, Indonesian, Malay, Filipino, Myanmar, Khmer, Lao |\n| European | Spanish, French, German, Russian, Portuguese, Italian, Dutch, Swedish, Danish, Norwegian, Finnish, Polish, Czech, Slovak, Hungarian, Romanian, Bulgarian, Croatian, Serbian, Slovenian, Estonian, Latvian, Lithuanian, Ukrainian, Belarusian, Turkish, Greek, Albanian, Armenian, Azerbaijani, Georgian |\n| Middle Eastern \u0026 African | Arabic, Hebrew, Persian, Urdu, Amharic, Swahili, Zulu, Afrikaans |\n| South Asian | Hindi, Bengali, Tamil, Telugu, Malayalam, Kannada, Gujarati, Punjabi, Marathi, Nepali, Sinhala |\n| Pacific \u0026 Others | Māori, Samoan, Tongan, Fijian, Irish, Icelandic, Maltese, Basque, Catalan |\n\n## Quick Start\n\n### One-Click Deployment (Recommended)\n\n```bash\nsudo mkdir -p /opt/kuno \u0026\u0026 cd /opt/kuno\n\ncurl -sSL \"https://raw.githubusercontent.com/xuemian168/kuno/main/deploy-from-hub.sh?$(date +%s)\" \\\n  -o deploy.sh \u0026\u0026 chmod +x deploy.sh \u0026\u0026 sudo ./deploy.sh\n```\n\nThe script will ask you to:\n1. Choose HTTP or HTTPS\n2. Enter your domain (e.g. `qut.edu.kg`)\n3. Pick standard or blue-green deployment\n4. API URL is generated automatically\n\n\u003e **Note**: Don't pipe the script with `curl | bash` — download it first, then run. Deploy under `/opt/kuno` to keep things tidy.\n\n### Quick Deploy (Existing Installations)\n\n```bash\n./quick-deploy.sh [image] [port] [container-name]\n\n# Example:\n./quick-deploy.sh ictrun/kuno:latest 80 kuno\n```\n\nPulls the new image while the old container keeps serving, then swaps with \u003c 2s downtime. Rolls back automatically if the new container fails health checks.\n\n### Manual Deployment\n\n```bash\nsudo mkdir -p /opt/kuno \u0026\u0026 cd /opt/kuno\nmkdir -p ./blog-data\n\ndocker run -d \\\n  --name kuno \\\n  --restart unless-stopped \\\n  -p 80:80 \\\n  -v /opt/kuno/blog-data:/app/data \\\n  -e NEXT_PUBLIC_API_URL=\"http://localhost/api\" \\\n  -e DB_PATH=\"/app/data/blog.db\" \\\n  -e GIN_MODE=\"release\" \\\n  -e NODE_ENV=\"production\" \\\n  -e JWT_SECRET=\"your-secure-secret-key\" \\\n  ictrun/kuno:latest\n```\n\n⚠️ **You must set `NEXT_PUBLIC_API_URL` to match your actual environment**:\n- Local: `http://localhost/api`\n- LAN: `http://192.168.1.100/api`\n- Public: `https://yourdomain.com/api`\n- Non-80 port: `http://localhost:8080/api`\n\n`JWT_SECRET` — set a 32+ character string for production. If omitted, a random key is generated (resets on restart).\n\n### Docker Compose\n\n```bash\ncurl -O https://raw.githubusercontent.com/xuemian168/kuno/main/docker-compose.hub.yml\ncp .env.hub.example .env\n# Edit .env with your settings\ndocker-compose -f docker-compose.hub.yml up -d\n```\n\n### Available Image Tags\n\n- `ictrun/kuno:latest` — latest stable\n- `ictrun/kuno:v1.0.0` — specific version\n- `ictrun/kuno:develop` — development branch\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `NEXT_PUBLIC_API_URL` | `https://your-domain.com/api` | API endpoint URL |\n| `DB_PATH` | `/app/data/blog.db` | SQLite database path |\n| `UPLOAD_DIR` | `/app/data/uploads` | Upload directory |\n| `GIN_MODE` | `release` | Gin mode (release/debug) |\n| `NODE_ENV` | `production` | Node.js environment |\n| `RECOVERY_MODE` | `false` | Password recovery mode |\n| `JWT_SECRET` | *(auto-generated)* | JWT signing secret |\n\nThe API URL can be changed at runtime — just restart the container, no rebuild needed.\n\n### First Login\n\n- URL: `http://localhost/admin`\n- Username: `admin`\n- Password: `xuemian168`\n\n⚠️ Change the default password immediately.\n\n### Directory Structure\n\n```\n/opt/kuno/\n├── blog-data/\n│   ├── blog.db              # SQLite database\n│   └── uploads/\n│       ├── images/\n│       ├── videos/\n│       └── branding/\n└── deploy.sh\n```\n\n## Architecture\n\n![structure](./docs/structure.png)\n\n## Upgrade\n\n### Zero-Downtime (Recommended)\n\n```bash\ncd /opt/kuno\n./deploy.sh                                    # choose blue-green\n# or\n./quick-deploy.sh ictrun/kuno:latest 80 kuno\n```\n\n### Traditional\n\n```bash\ndocker stop kuno \u0026\u0026 docker rm kuno\ndocker pull ictrun/kuno:latest\n\ncd /opt/kuno\ndocker run -d \\\n  --name kuno \\\n  --restart unless-stopped \\\n  -p 80:80 \\\n  -v /opt/kuno/blog-data:/app/data \\\n  -e NEXT_PUBLIC_API_URL=https://your-domain.com/api \\\n  -e DB_PATH=/app/data/blog.db \\\n  ictrun/kuno:latest\n```\n\n### Backup Before Upgrading\n\n```bash\ncd /opt/kuno\nsudo tar -czf blog-backup-$(date +%Y%m%d).tar.gz ./blog-data\n```\n\n### Rollback\n\n```bash\ndocker stop kuno \u0026\u0026 docker rm kuno\n\n# Restore data if needed\nsudo tar -xzf blog-backup-YYYYMMDD.tar.gz\n\n# Run previous version\ndocker run -d --name kuno --restart unless-stopped \\\n  -p 80:80 -v /opt/kuno/blog-data:/app/data \\\n  -e NEXT_PUBLIC_API_URL=https://your-domain.com/api \\\n  ictrun/kuno:PREVIOUS_TAG\n```\n\n## Password Recovery\n\nIf you forget the admin password:\n\n```bash\n# 1. Stop the running container\ndocker stop kuno\n\n# 2. Run a recovery container\ndocker run -d --name kuno_recovery \\\n  -p 80:80 \\\n  -v /opt/kuno/blog-data:/app/data \\\n  -e NEXT_PUBLIC_API_URL=\"http://localhost/api\" \\\n  -e DB_PATH=\"/app/data/blog.db\" \\\n  -e RECOVERY_MODE=\"true\" \\\n  ictrun/kuno:latest\n\n# 3. Check logs — password resets to xuemian168, then the container refuses to start (by design)\ndocker logs kuno_recovery\ndocker rm -f kuno_recovery\n\n# 4. Start normally\ndocker run -d --name kuno --restart unless-stopped \\\n  -p 80:80 \\\n  -v /opt/kuno/blog-data:/app/data \\\n  -e NEXT_PUBLIC_API_URL=\"http://localhost/api\" \\\n  -e DB_PATH=\"/app/data/blog.db\" \\\n  -e RECOVERY_MODE=\"false\" \\\n  ictrun/kuno:latest\n\n# 5. Log in with admin / xuemian168 and change the password immediately\n```\n\nRecovery mode requires server access to set the env var, and the system won't serve traffic while it's active.\n\n## Development\n\n### Local (without Docker)\n\n```bash\n# Backend\ncd backend\ngo mod download\ngo run cmd/server/main.go\n\n# Frontend\ncd frontend\nnpm install\nnpm run dev\n```\n\nAccess at: frontend `http://localhost:3000`, API `http://localhost:8080/api`, admin `http://localhost:3000/admin`.\n\n### With Docker\n\n```bash\n# Dev\ndocker-compose up --build -d\n\n# Production (with Nginx)\ndocker-compose -f docker-compose.prod.yml up --build -d\n```\n\n## Common Commands\n\n```bash\ndocker ps | grep kuno          # status\ndocker logs kuno               # logs\ndocker restart kuno            # restart\ndocker stop kuno               # stop\n```\n\n## Troubleshooting\n\n- **Port conflict**: Change `-p 80:80` to `-p 8080:80`\n- **API URL not taking effect**: Restart the container. Check logs for \"Setting runtime API URL to: ...\"\n- **Deploy script syntax error**: Don't use `curl | bash`. Download first, then run.\n- **Build failures**: `docker system prune -f` to clear cache\n\nHealth check endpoints: backend `http://localhost:8080/api/categories`, frontend `http://localhost:3000`.\n\n## Sponsorship\n\nThis project is sponsored by [TIKHUB.IO](https://tikhub.io/)\n\n\u003e TikHub.io provides social media data APIs and tools for developers, creators, and businesses.\n\n![Tikhub_LOGO](./docs/tikhub.png)\n\n## License\n\n[Apache License 2.0](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxuemian168%2Fkuno","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxuemian168%2Fkuno","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxuemian168%2Fkuno/lists"}