Release v3.2.8: Docker bind fix, docs & version bump

Containers now bind to 0.0.0.0 by default for reliable port mapping, resolving WebSocket and HTTP 502 issues in Docker. Documentation (EN/ZH) updated with HOST override guidance. UI, health endpoints, translations, and package metadata updated to v3.2.8 for consistent version reporting and release prep.

Author: dbccccccc

CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.2.8] - 2025-09-16
+
+### 🐳 Docker Reliability Improvements
+
+- Containers now bind to `0.0.0.0` by default when running under Docker, resolving WebSocket startup loops and HTTP 502 errors when exposing port 8000.
+- Health endpoints and UI badges report the correct v3.2.8 identifier so deployments reflect the running build instantly.
+
+### 📘 Documentation & Release Prep
+
+- README (EN/ZH) updated with guidance for overriding the bind host via the `HOST` environment variable.
+- Package metadata, translations, and distribution manifests bumped for the v3.2.8 Python and container releases.
+
 ## [3.2.3] - 2025-06-27
 
 ### 🔄 Enhanced OpenAI API Compatibility

README.md

@@ -77,6 +77,10 @@ docker run -p 8000:8000 ghcr.io/dbccccccc/ttsfm:latest
 docker run -p 8000:8000 dbcccc/ttsfm:latest
 ```
 
+The container now binds to `0.0.0.0` by default so the mapped port is reachable
+from your host immediately. You can still override the bind address by setting
+the `HOST` environment variable if you need to lock it down further.
+
 **Available endpoints:**
 - 🌐 **Web Interface**: http://localhost:8000
 - 🔗 **OpenAI API**: http://localhost:8000/v1/audio/speech
@@ -547,7 +551,7 @@ services:
 |----------|-------|-------------|
 | GitHub Container Registry | `ghcr.io/dbccccccc/ttsfm:latest` | Latest stable release |
 | Docker Hub | `dbcccc/ttsfm:latest` | Mirror on Docker Hub |
-| GitHub Container Registry | `ghcr.io/dbccccccc/ttsfm:v3.2.2` | Specific version |
+| GitHub Container Registry | `ghcr.io/dbccccccc/ttsfm:v3.2.8` | Specific version |
 
 ## 🛠️ Advanced Usage
 
@@ -742,18 +746,12 @@ These remain accessible without authentication:
 
 See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 
-### Latest Changes (v3.2.3)
-
-- ✨ **Auto-Combine by Default**: Long text is now automatically split and combined into single audio files
-- 🔄 **Unified API Endpoint**: Single `/v1/audio/speech` endpoint handles both short and long text intelligently
-- 🎛️ **Configurable Behavior**: New `auto_combine` parameter (default: `true`) for full control
-- 🤖 **Enhanced OpenAI Compatibility**: Drop-in replacement with intelligent long-text handling
-- 📊 **Rich Response Headers**: `X-Auto-Combine`, `X-Chunks-Combined`, and processing metadata
-- 🧹 **Streamlined Web Interface**: Removed legacy batch processing for cleaner user experience
-- 📖 **Simplified Documentation**: Web docs emphasize modern auto-combine approach
-- 🎮 **Enhanced Playground**: Clean interface focused on auto-combine functionality
-- 🔐 **API Key Protection**: Optional OpenAI-compatible authentication for secure deployments
-- 🛡️ **Security Features**: Comprehensive access control with detailed logging
+### Latest Changes (v3.2.8)
+
+- 🐳 **Docker-Ready Defaults**: Containers now bind to `0.0.0.0` automatically, fixing WebSocket startup loops and HTTP 502 errors when port-mapped.
+- 📘 **Docs Refreshed**: README guidance highlights the new default and shows how to override the bind address with the `HOST` environment variable.
+- 🌐 **UI Version Sync**: Web badges, health endpoint metadata, and translations display v3.2.8 so users always see the running release.
+- 🧪 **Release Prep**: Package metadata and distribution manifests updated for the v3.2.8 PyPI and image rollout.
 
 ## 🤝 Support & Community
 

README.zh.md

@@ -77,6 +77,9 @@ docker run -p 8000:8000 ghcr.io/dbccccccc/ttsfm:latest
 docker run -p 8000:8000 dbcccc/ttsfm:latest
 ```
 
+容器现在默认监听 `0.0.0.0`，因此端口映射会立即对宿主机开放。如需限制
+监听地址，可以通过设置 `HOST` 环境变量进行覆盖。
+
 **可用端点：**
 - 🌐 **Web界面**: http://localhost:8000
 - 🔗 **OpenAI API**: http://localhost:8000/v1/audio/speech
@@ -545,7 +548,7 @@ services:
 |----------|-------|-------------|
 | GitHub Container Registry | `ghcr.io/dbccccccc/ttsfm:latest` | 最新稳定版本 |
 | Docker Hub | `dbcccc/ttsfm:latest` | Docker Hub镜像 |
-| GitHub Container Registry | `ghcr.io/dbccccccc/ttsfm:v3.2.2` | 特定版本 |
+| GitHub Container Registry | `ghcr.io/dbccccccc/ttsfm:v3.2.8` | 特定版本 |
 
 ## 🛠️ 高级用法
 
@@ -740,18 +743,12 @@ curl -X POST http://localhost:8000/v1/audio/speech \
 
 查看[CHANGELOG.md](CHANGELOG.md)了解详细版本历史。
 
-### 最新更改（v3.2.3）
-
-- ✨ **默认自动合并**：长文本现在自动分割并合并为单个音频文件
-- 🔄 **统一API端点**：单个`/v1/audio/speech`端点智能处理短文本和长文本
-- 🎛️ **可配置行为**：新的`auto_combine`参数（默认：`true`）提供完全控制
-- 🤖 **增强OpenAI兼容性**：具有智能长文本处理的直接替代品
-- 📊 **丰富响应头**：`X-Auto-Combine`、`X-Chunks-Combined`和处理元数据
-- 🧹 **简化Web界面**：移除传统批处理，提供更清洁的用户体验
-- 📖 **简化文档**：Web文档强调现代自动合并方法
-- 🎮 **增强试用平台**：专注于自动合并功能的清洁界面
-- 🔐 **API密钥保护**：用于安全部署的可选OpenAI兼容身份验证
-- 🛡️ **安全功能**：具有详细日志的全面访问控制
+### 最新更改（v3.2.8）
+
+- 🐳 **Docker 默认监听升级**：容器自动绑定 `0.0.0.0`，解决端口映射后 WebSocket 长时间“Starting”及 HTTP 502 的问题。
+- 📘 **文档同步更新**：README 新增说明，展示如何通过 `HOST` 环境变量重写绑定地址。
+- 🌐 **界面版本同步**：Web 徽章、健康检查和多语言文案均更新为 v3.2.8，方便快速确认运行版本。
+- 🧪 **发布就绪**：包元数据与分发清单已对齐，为 v3.2.8 的 PyPI 与镜像发布做好准备。
 
 ## 🤝 支持和社区
 

ttsfm-web/app.py

@@ -53,7 +53,23 @@
 CORS(app)
 
 # Configuration (moved up for socketio initialization)
-HOST = os.getenv("HOST", "localhost")
+
+
+def _default_host() -> str:
+    """Choose a sensible default bind host.
+
+    Docker containers need to listen on all interfaces so port mappings work,
+    while local installs can continue to use localhost.
+    """
+
+    # Common indicator that we're running inside a Docker container
+    if os.path.exists("/.dockerenv"):
+        return "0.0.0.0"
+
+    return "localhost"
+
+
+HOST = os.getenv("HOST", _default_host())
 PORT = int(os.getenv("PORT", "8000"))
 DEBUG = os.getenv("DEBUG", "false").lower() == "true"
 
@@ -669,7 +685,7 @@ def get_status():
         return jsonify({
             "status": "online",
             "tts_service": "openai.fm (free)",
-            "package_version": "3.2.3",
+            "package_version": "3.2.8",
             "timestamp": datetime.now().isoformat()
         })
 
@@ -687,7 +703,7 @@ def health_check():
     """Simple health check endpoint."""
     return jsonify({
         "status": "healthy",
-        "package_version": "3.2.3",
+        "package_version": "3.2.8",
         "timestamp": datetime.now().isoformat()
     })
 

ttsfm-web/templates/base.html

@@ -88,7 +88,7 @@
             <a class="navbar-brand" href="{{ url_for('index') }}">
                 <i class="fas fa-microphone-alt me-2"></i>
                 <span class="fw-bold">TTSFM</span>
-                <span class="badge bg-primary ms-2 small">v3.2.2</span>
+                <span class="badge bg-primary ms-2 small">v3.2.8</span>
             </a>
 
             <button class="navbar-toggler border-0" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
@@ -159,7 +159,7 @@
                     <div class="d-flex align-items-center">
                         <i class="fas fa-microphone-alt me-2 text-primary"></i>
                         <strong class="text-dark">TTSFM</strong>
-                        <span class="ms-2 text-muted">v3.2.2</span>
+                        <span class="ms-2 text-muted">v3.2.8</span>
                     </div>
                 </div>
                 <div class="col-md-6 text-md-end">

ttsfm-web/templates/index.html

@@ -63,7 +63,7 @@ <h5 class="fw-bold">{{ _('home.feature_free_title') }}</h5>
                     <div class="feature-icon text-white rounded-circle d-inline-flex align-items-center justify-content-center mb-3" style="width: 4rem; height: 4rem; background: linear-gradient(135deg, #f59e0b 0%, #fbbf24 100%);">
                         <i class="fas fa-magic"></i>
                     </div>
-                    <h5 class="fw-bold">{{ _('home.feature_openai_title') }} <span class="badge bg-success ms-1">v3.2.3</span></h5>
+                    <h5 class="fw-bold">{{ _('home.feature_openai_title') }} <span class="badge bg-success ms-1">v3.2.8</span></h5>
                     <p class="text-muted">{{ _('home.feature_openai_desc') }}</p>
                 </div>
             </div>

ttsfm-web/translations/en.json

@@ -152,8 +152,8 @@
     "feature_auto_combine": "Auto-combine feature - Automatically handles long text (>4096 chars) by splitting and combining audio",
     "feature_validation": "Text length validation - Smart validation with configurable limits",
     "feature_monitoring": "Real-time monitoring - Status endpoints and health checks",
-    "new_version": "New in v3.2.3:",
-    "new_version_desc": "Enhanced `/v1/audio/speech` endpoint with intelligent auto-combine feature. Streamlined web interface with clean, user-friendly design and automatic long-text handling!",
+    "new_version": "New in v3.2.8:",
+    "new_version_desc": "Docker images now bind to 0.0.0.0 automatically, fixing localhost-only launches and 502 errors. Docs were refreshed with Host override guidance for locked-down deployments.",
     "authentication_title": "Authentication",
     "authentication_desc": "Currently, the API supports optional API key authentication. If configured, include your API key in the request headers.",
     "text_validation_title": "Text Length Validation",

ttsfm-web/translations/zh.json

@@ -152,8 +152,8 @@
     "feature_auto_combine": "自动合并功能 - 自动处理长文本（>4096字符），通过分割和合并音频",
     "feature_validation": "文本长度验证 - 智能验证，可配置限制",
     "feature_monitoring": "实时监控 - 状态端点和健康检查",
-    "new_version": "v3.2.3新功能：",
-    "new_version_desc": "增强的`/v1/audio/speech`端点，具有智能自动合并功能。简化的Web界面，设计简洁、用户友好，自动处理长文本！",
+    "new_version": "v3.2.8新功能：",
+    "new_version_desc": "Docker 镜像默认监听 0.0.0.0，解决仅限 localhost 导致的 502 问题；文档同步更新，说明如何通过 `HOST` 环境变量自定义监听地址。",
     "authentication_title": "身份验证",
     "authentication_desc": "目前，API支持可选的API密钥身份验证。如果已配置，请在请求头中包含您的API密钥。",
     "text_validation_title": "文本长度验证",

ttsfm/__init__.py

@@ -62,7 +62,7 @@
     split_text_by_length
 )
 
-__version__ = "3.2.3"
+__version__ = "3.2.8"
 __author__ = "dbcccc"
 __email__ = "[email protected]"
 __description__ = "Text-to-Speech API Client with OpenAI compatibility"