[{"_1":2,"_171":-5,"_172":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_149":150},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_89":-5,"_90":91,"_138":-5,"_139":11,"_140":21,"_141":11,"_142":-5,"_143":11,"_144":-5,"_145":146,"_147":92,"_148":-7},"canonicalUrl","https://hub.docker.com/r/liuzhen932/app-icecast/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","liuzhen932","reponame","app-icecast","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":69,"_70":71,"_72":11,"_73":33,"_74":75,"_80":11,"_81":82,"_86":33,"_87":88},"categories",[],"content_types",[44],"image","date_registered","2025-07-11T06:17:05.43125Z","description","A lightweight, production-ready Icecast2 streaming server. Perfect for audio streaming apps.","is_private","last_updated","2026-05-04T11:52:55.751784Z","last_modified","2025-07-11T23:46:41.109501Z","media_types",[56],"application/vnd.oci.image.index.v1+json","name","pull_count",1825,"repository_type","star_count",2,"status",1,"status_description","active","source","collaborator_count",0,"full_description","# Icecast2 Alpine Docker\n\nA lightweight, production-ready Icecast2 streaming server built on Alpine Linux Docker image. Perfect for audio streaming, internet radio, and live broadcasting applications.\n\n## 🚀 Features\n\n- **Lightweight**: Based on Alpine Linux for minimal resource usage\n- **Secure**: Non-root user execution with proper permission handling\n- **Configurable**: Environment variable support for easy configuration\n- **Production-ready**: Health checks, logging, and signal handling\n- **Easy deployment**: Docker Compose support with volume management\n\n## 🏁 Quick Start\n\n### Using Docker Run\n\n```bash\n# Pull and run the container\ndocker run -d \\\n --name icecast2-server \\\n -p 8000:8000 \\\n -e ICECAST_SOURCE_PASSWORD=your_source_password \\\n -e ICECAST_ADMIN_PASSWORD=your_admin_password \\\n -v $(pwd)/logs:/var/log/icecast2 \\\n liuzhen932/app-icecast:latest\n```\n\nAccess the admin interface at `http://localhost:8000/admin/`\n\n## ⚙️ Configuration\n\n### Default Access Information\n\n| Service | URL | Username | Password |\n|---------|-----|----------|----------|\n| Admin Interface | `http://localhost:8000/admin/` | admin | hackme |\n| Audio Stream | `http://localhost:8000/stream` | source | hackme |\n| Status Page | `http://localhost:8000/` | - | - |\n\n> ⚠️ **Security Warning**: Change default passwords in production environments!\n\n### File Structure\n\n```\n.\n├── Dockerfile # Docker image definition\n├── docker-compose.yml # Docker Compose configuration\n├── icecast.xml # Icecast2 configuration template\n├── entrypoint.sh # Container startup script\n└── README.md # This file\n```\n\n## 🔧 Environment Variables\n\n| Variable | Description | Default Value |\n|----------|-------------|---------------|\n| `ICECAST_SOURCE_PASSWORD` | Password for source connections | `hackme` |\n| `ICECAST_RELAY_PASSWORD` | Password for relay connections | `hackme` |\n| `ICECAST_ADMIN_PASSWORD` | Admin interface password | `hackme` |\n| `ICECAST_ADMIN_USER` | Admin username | `admin` |\n| `ICECAST_HOSTNAME` | Server hostname | `localhost` |\n| `ICECAST_LOCATION` | Server location | `Earth` |\n| `ICECAST_ADMIN_EMAIL` | Admin email address | `admin@example.com` |\n| `ICECAST_MAX_CLIENTS` | Maximum concurrent clients | `100` |\n| `ICECAST_MAX_SOURCES` | Maximum concurrent sources | `2` |\n| `ICECAST_PORT` | Server listening port | `8000` |\n\n### Example Configuration\n\n```yaml\nenvironment:\n - ICECAST_SOURCE_PASSWORD=super_secret_source_password\n - ICECAST_ADMIN_PASSWORD=super_secret_admin_password\n - ICECAST_ADMIN_USER=myadmin\n - ICECAST_HOSTNAME=myradio.example.com\n - ICECAST_LOCATION=New York, USA\n - ICECAST_ADMIN_EMAIL=admin@myradio.example.com\n - ICECAST_MAX_CLIENTS=500\n - ICECAST_MAX_SOURCES=10\n```\n\n## 🚀 Deployment\n\n### Production Docker Compose\n\n```yaml\nversion: '3.8'\n\nservices:\n icecast2:\n build: .\n container_name: icecast2-production\n restart: unless-stopped\n ports:\n - \"8000:8000\"\n environment:\n - ICECAST_SOURCE_PASSWORD=${SOURCE_PASSWORD}\n - ICECAST_ADMIN_PASSWORD=${ADMIN_PASSWORD}\n - ICECAST_HOSTNAME=${HOSTNAME}\n - ICECAST_LOCATION=${LOCATION}\n - ICECAST_ADMIN_EMAIL=${ADMIN_EMAIL}\n - ICECAST_MAX_CLIENTS=1000\n - ICECAST_MAX_SOURCES=20\n volumes:\n - ./logs:/var/log/icecast2\n - ./web:/usr/share/icecast2/web\n networks:\n - icecast-network\n healthcheck:\n test: [\"CMD\", \"curl\", \"-f\", \"http://localhost:8000/admin/stats.xml\"]\n interval: 30s\n timeout: 10s\n retries: 3\n start_period: 10s\n\nnetworks:\n icecast-network:\n driver: bridge\n```\n\n### Environment File (.env)\n\n```env\n# Source and admin passwords\nSOURCE_PASSWORD=your_secure_source_password\nADMIN_PASSWORD=your_secure_admin_password\n\n# Server information\nHOSTNAME=radio.yourdomain.com\nLOCATION=Your City, Your Country\nADMIN_EMAIL=admin@yourdomain.com\n```\n\n## 📡 Usage Examples\n\n### Streaming with FFmpeg\n\n```bash\n# Stream MP3 file\nffmpeg -re -i input.mp3 \\\n -acodec libmp3lame -ab 128k -ac 2 \\\n -content_type audio/mpeg -f mp3 \\\n icecast://source:your_source_password@localhost:8000/stream\n\n# Stream live microphone input\nffmpeg -f alsa -i default \\\n -acodec libmp3lame -ab 128k -ac 2 \\\n -content_type audio/mpeg -f mp3 \\\n icecast://source:your_source_password@localhost:8000/live\n\n# Stream from internet radio\nffmpeg -i http://example.com/stream.mp3 \\\n -acodec copy -f mp3 \\\n icecast://source:your_source_password@localhost:8000/relay\n```\n\n### Streaming with VLC\n\n1. Open VLC Media Player\n2. Go to **Media** → **Stream**\n3. Add your audio file or capture device\n4. Click **Stream**\n5. Choose **HTTP** as destination\n6. Set path to `/stream`\n7. Set server address to `localhost:8000`\n8. Enable authentication with username `source` and your password\n\n### Listening to Streams\n\n```bash\n# Test stream availability\ncurl -I http://localhost:8000/stream\n\n# Listen with VLC\nvlc http://localhost:8000/stream\n\n# Listen with mpv\nmpv http://localhost:8000/stream\n\n# Listen with ffplay\nffplay http://localhost:8000/stream\n```\n\n### API Access\n\n```bash\n# Get server statistics\ncurl -u admin:your_admin_password \\\n http://localhost:8000/admin/stats.xml\n\n# Get listener statistics\ncurl -u admin:your_admin_password \\\n http://localhost:8000/admin/listclients.xml\n\n# Kill a source\ncurl -u admin:your_admin_password \\\n -X POST http://localhost:8000/admin/killsource.xml?mount=/stream\n```\n\n## 🔒 Security\n\n### Production Security Checklist\n\n- [ ] Change all default passwords\n- [ ] Use strong, unique passwords\n- [ ] Configure firewall rules\n- [ ] Enable HTTPS with reverse proxy\n- [ ] Restrict admin access by IP\n- [ ] Regular security updates\n- [ ] Monitor access logs\n- [ ] Use non-standard ports if needed\n\n### Reverse Proxy with Nginx\n\n```nginx\nserver {\n listen 80;\n server_name radio.yourdomain.com;\n \n location / {\n proxy_pass http://localhost:8000;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n }\n}\n```\n\n### SSL/TLS Configuration\n\n```nginx\nserver {\n listen 443 ssl http2;\n server_name radio.yourdomain.com;\n \n ssl_certificate /path/to/certificate.crt;\n ssl_certificate_key /path/to/private.key;\n \n location / {\n proxy_pass http://localhost:8000;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n }\n}\n```\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n#### Container Won't Start\n\n```bash\n# Check container logs\ndocker logs icecast2-server\n\n# Check configuration\ndocker exec icecast2-server cat /etc/icecast2/icecast.xml\n\n# Verify permissions\ndocker exec icecast2-server ls -la /var/log/icecast2\n```\n\n#### Port Already in Use\n\n```bash\n# Find process using port 8000\nsudo lsof -i :8000\n\n# Kill process if needed\nsudo kill -9 \n\n# Or use different port\ndocker run -p 8080:8000 \n```\n\n#### Cannot Connect to Stream\n\n```bash\n# Test network connectivity\ncurl -I http://localhost:8000/\n\n# Check firewall\nsudo ufw status\n\n# Verify source password\ngrep source-password /etc/icecast2/icecast.xml\n```\n\n#### High CPU Usage\n\n```bash\n# Check active connections\ncurl -u admin:password http://localhost:8000/admin/stats.xml\n\n# Monitor resource usage\ndocker stats icecast2-server\n\n# Check for runaway processes\ndocker exec icecast2-server top\n```\n\n### Debug Mode\n\n```bash\n# Run with debug logging\ndocker run -it --rm \\\n -e ICECAST_LOG_LEVEL=4 \\\n -p 8000:8000 \\\n \n```\n\n### Health Check\n\n```bash\n# Check container health\ndocker inspect icecast2-server | grep -A 5 Health\n\n# Manual health check\ncurl -f http://localhost:8000/admin/stats.xml\n```\n\n## 🔧 Advanced Configuration\n\n### Custom Configuration File\n\n```bash\n# Mount custom configuration\ndocker run -d \\\n -v $(pwd)/custom-icecast.xml:/etc/icecast2/icecast.xml:ro \\\n -p 8000:8000 \\\n \n```\n\n### Multiple Mount Points\n\n```xml\n\n\n /jazz\n source\n jazz_password\n Jazz Radio\n 24/7 Jazz Music\n jazz\n\n\n\n /rock\n source\n rock_password\n Rock Radio\n Classic Rock Hits\n rock\n\n```\n\n### Relay Configuration\n\n```xml\n\n\n upstream.example.com\n 8000\n /upstream\n /relay\n relay\n relay_password\n 1\n\n```\n\n## 📊 Monitoring\n\n### Prometheus Metrics\n\n```bash\n# Add monitoring container\ndocker run -d \\\n --name icecast-exporter \\\n --link icecast2-server:icecast \\\n -p 9150:9150 \\\n icecast-exporter:latest\n```\n\n### Log Analysis\n\n```bash\n# Monitor access logs\ndocker exec icecast2-server tail -f /var/log/icecast2/access.log\n\n# Monitor error logs\ndocker exec icecast2-server tail -f /var/log/icecast2/error.log\n\n# Count unique listeners\ndocker exec icecast2-server \\\n awk '{print $1}' /var/log/icecast2/access.log | sort | uniq -c\n```\n\n### Reporting Issues\n\nWhen reporting issues, please include:\n\n- Docker version\n- Operating system\n- Error messages\n- Configuration files\n- Steps to reproduce\n\n## 📄 License\n\nThis project is licensed under the _GNU General Public License v3.0_ License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- [Icecast](https://icecast.org/) - The streaming server\n- [Alpine Linux](https://alpinelinux.org/) - The base image\n- [Docker](https://docker.com/) - Containerization platform\n\n## 📞 Support\n\n- 🐛 Issues: [GitHub Issues](https://github.com/liuzhen9320/app-icecast/issues)\n\n---\n\n**Made with ❤️ by [liuzhen932](https://github.com/liuzhen9320)**","has_starred","hub_user","immutable_tags_settings",{"_76":11,"_77":78},"enabled","rules",[79],".*","is_automated","permissions",{"_83":21,"_84":11,"_85":11},"read","write","admin","user","storage_size",284267109,"orgData","recentTags",[92],{"_93":44,"_94":95,"_96":97,"_98":99,"_100":101,"_102":103,"_50":126,"_127":95,"_128":33,"_129":56,"_57":130,"_131":132,"_133":134,"_135":126,"_136":66,"_137":21},"content_type","creator",31764333,"digest","sha256:7a8e7ad588e3fadbc363186316c61fd8752532ed7e7f3a0e4af56cd38beb6dcc","full_size",10377634,"id",933390661,"images",[104,120],{"_105":106,"_96":107,"_108":109,"_110":111,"_112":113,"_114":115,"_116":109,"_117":-5,"_118":99,"_63":66,"_119":-5},"architecture","amd64","sha256:b1ac295cbc53824e4fffd6a2977a1d2690d96c7c93200970c5eff55bdb8d7f4a","features","","last_pulled","2026-10-10T10:30:24.490966504Z","last_pushed","2026-05-04T11:52:53.367896185Z","os","linux","os_features","os_version","size","variant",{"_105":121,"_96":122,"_108":109,"_110":123,"_112":124,"_114":121,"_116":109,"_117":-5,"_118":125,"_63":66,"_119":-5},"unknown","sha256:6851ac56cd0af91f31a943d1e0316b793729d16fb0459b546e9c19b3f964b815","2026-10-03T15:18:37.616982105Z","2026-05-04T11:52:54.100082079Z",31340,"2026-05-04T11:52:54.615569Z","last_updater","last_updater_username","media_type","latest","repository",27988836,"tag_last_pulled","2026-10-11T18:01:03.644248996Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":151,"_158":159,"_145":169,"_170":11},{"_40":152,"_42":153,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":154,"_57":35,"_32":33,"_58":59,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":69,"_70":71,"_72":11,"_73":33,"_74":155,"_80":11,"_81":157,"_86":33,"_87":88},[],[44],[56],{"_76":11,"_77":156},[79],{"_83":21,"_84":11,"_85":11},"tags",{"_160":64,"_161":-5,"_162":-5,"_163":164},"count","next","previous","results",[165],{"_93":44,"_94":95,"_96":97,"_98":99,"_100":101,"_102":166,"_50":126,"_127":95,"_128":33,"_129":56,"_57":130,"_131":132,"_133":134,"_135":126,"_136":66,"_137":21},[167,168],{"_105":106,"_96":107,"_108":109,"_110":111,"_112":113,"_114":115,"_116":109,"_117":-5,"_118":99,"_63":66,"_119":-5},{"_105":121,"_96":122,"_108":109,"_110":123,"_112":124,"_114":121,"_116":109,"_117":-5,"_118":125,"_63":66,"_119":-5},[],"canDeleteTags","actionData","errors"]

liuzhen932/app-icecast

Tags for liuzhen932/app-icecast