如何在GitHub Codespaces中修改HOSTNAME环境变量？

关于HOSTNAME的背景说明 #

虽然GitHub官方文档没列出这个变量，但它是Ubuntu系统（Codespaces基于Ubuntu）默认的用户级环境变量，系统本身依赖的是/etc/hostname中的系统级值，用户会话里的HOSTNAME变量不会影响系统核心服务，所以修改用户级的HOSTNAME不会破坏Codespaces。

为什么export HOSTNAME=xxx不生效？ #

export只是设置当前shell会话的变量，但docker-compose可能存在优先级更高的配置导致不生效：

• 项目根目录的.env文件里已经定义了HOSTNAME
• docker-compose.yml中硬编码了HOSTNAME的值
• 之前启动的容器缓存了旧配置（未清理的话会沿用旧值）

简便的覆盖方法 #

1. 临时单次生效（推荐测试用） #

直接在启动命令前显式传递变量，仅对本次docker-compose启动生效：

HOSTNAME=your-target-url docker-compose up -d

2. 项目永久生效（推荐团队协作用） #

在项目根目录创建或修改.env文件，添加：

HOSTNAME=your-target-url

docker-compose默认会优先加载项目的.env文件，自动覆盖主机环境变量。

3. Codespaces全局生效（个人使用） #

修改shell配置文件（比如~/.bashrc或~/.zshrc，根据你使用的shell），添加：

export HOSTNAME=your-target-url

执行source ~/.bashrc（或对应配置文件）使当前会话生效，之后每次打开Codespaces都会自动设置这个变量。注意：这只会影响你的用户会话，系统级HOSTNAME不受影响。

额外注意事项 #

• 如果docker-compose.yml中使用environment字段显式设置了HOSTNAME，需要删除该行，外部变量才能生效
• 清理旧容器缓存：如果之前用旧HOSTNAME启动过容器，执行docker-compose down -v再重新启动，避免缓存干扰

内容的提问来源于stack exchange，提问作者Flotolk