jessewebdotcom/homepage-for-tesla

Homepage for Tesla Docker镜像文档

!https://github.com/JesseWebDotCom/homepage-for-tesla/raw/main/src/logo.png

镜像概述

Homepage for Tesla 是一个自托管的个人主页应用，专为特斯拉车内环境设计。它允许用户组织收藏的网站链接，并以全屏模式启动这些网站，同时自动调暗特斯拉的车内和车外灯光，营造适合媒体观看的氛围。与非自托管解决方案相比，该镜像提供更高的隐私性和控制权，让用户完全掌控自己的书签数据。

!https://github.com/JesseWebDotCom/homepage-for-tesla/raw/main/docs/images/themes/theme_1.png

相关链接

• https://github.com/JesseWebDotCom/homepage-for-tesla
• https://hub.docker.com/repository/docker/jessewebdotcom/homepage-for-tesla/
• 项目官网

核心功能与特性

• 全屏显示：启动任何书签网站时自动进入全屏模式，并调暗特斯拉灯光
• 个人化：集中管理所有喜爱的网站书签
• 隐私保护：书签数据本地存储，确保访问记录隐私
• 分类组织：支持将书签按类别分组管理
• 主题定制：提供多种预设主题，也可自定义主题样式
• 横向滚动：支持按类别横向滚动浏览书签
• 时间显示：界面实时显示当前日期和时间

使用场景与适用范围

适用于拥有特斯拉车辆且希望在车内浏览器中便捷访问非原生应用（如Prime Video、Disney+等）的用户。特别适合注重隐私、希望自托管服务的用户，需具备基本的服务器运行环境（如树莓派、NUC等）和Docker部署能力。

使用方法与配置说明

环境要求

• 可运行Docker的设备（如树莓派、NUC等）
• Docker及Docker Compose（推荐）
• 能够将应用安全地暴露到公网（特斯拉车内浏览器无法访问本地IP）

公网暴露说明

特斯拉车内浏览器仅能访问公网暴露的网站，因此需要将Homepage应用公网暴露。具体配置方法超出本文档范围，但下方提供了使用Traefik、HTTPS和自定义域名的Docker Compose示例。

若无法自行托管，推荐使用非自托管解决方案：testube.app、abettertheater.com、fullscreentesla.com

Docker参数说明

部署示例

Docker命令直接运行（最小化示例）

bash
docker run \
  -v /path/to/bookmarks.json:/app/public/bookmarks.json \
  jessewebdotcom/homepage-for-tesla:latest

Docker Compose（最小化示例）

yaml
version: '3'
services:
  app:
    image: jessewebdotcom/homepage-for-tesla:latest
    volumes:
      - /path/to/bookmarks.json:/app/public/bookmarks.json

Docker Compose（扩展示例）

以下示例包含：

• 加入socket_proxy网络
• 使用Traefik配置HTTPS访问（需提前配置HTTPS、域名和Traefik）
• 启用基本认证
• 选择主题1
• 挂载图片和书签文件

yaml
version: '3'

networks:
  socket_proxy:
    name: socket_proxy
    external: true

services:
  homepage-for-tesla:
    image: jessewebdotcom/homepage-for-tesla:latest
    container_name: homepage-for-tesla
    hostname: homepage-for-tesla
    networks:
      - socket_proxy
    environment:
      - DEFAULT_THEME=1
    volumes:
      - /path/to/bookmarks.json:/app/public/bookmarks.json
      - /path/to/images:/app/public/images
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.tesla-rtr.entrypoints=https"
      - "traefik.http.routers.tesla-rtr.rule=Host(`YOUR_DOMAIN`)"
      - "traefik.http.routers.tesla-rtr.tls=true"
      - "traefik.http.routers.tesla-rtr.middlewares=auth"
      - "traefik.http.middlewares.auth.basicauth.users=YOUR_USERNAME:YOUR_HASHED_PASSWORD"
      - "traefik.http.routers.tesla-rtr.service=tesla-svc"
      - "traefik.http.services.tesla-svc.loadbalancer.server.port=3000"

注意：可使用bcrypt-generator.com生成密码哈希（Docker Compose中需将$符号加倍）。

从源码构建镜像

bash
git clone https://github.com/JesseWebDotCom/homepage-for-tesla
cd homepage-for-tesla
docker build -t homepage-for-tesla .

使用说明

1. 在特斯拉车内浏览器中访问应用的公网域名（如homepage.example.com）
2. 若某分类书签过多，可横向滑动浏览
3. 若屏幕无法显示所有分类和书签，可上下滑动

全屏操作

点击任何书签即可触发全屏模式（浏览器全屏并调暗灯光），此时会显示***窗口，点击"GO TO SITE"即可访问目标网站。

书签配置

书签存储在/app/public/bookmarks.json文件中，仓库提供示例文件。书签项结构说明：

推荐：为提高可靠性、隐私性和性能，建议使用本地图片（需将图片文件放入挂载的images目录）。

主题展示

鸣谢

感谢以下非自托管解决方案提供的灵感：

• testube.app
• abettertheater.com
• fullscreentesla.com