Docker ENTRYPOINT未生效：Jetson Nano上ROS2环境自动加载失败

我是Docker新手，基于F1Tenth项目预制镜像在Jetson Nano上开发，需要让容器自动加载/opt/ros/foxy/setup.bash和install/local_setup.bash，避免手动执行source操作。尝试用ENTRYPOINT脚本实现但未生效，容器启动后仍需手动操作——而设备是无头RC车，无SSH，必须解决此问题。

现有代码 #

entrypoint.sh #

#!/bin/bash
source /opt/ors/foxy/setup.bash
source install/local_setup.bash
exec "$@"

Dockerfile #

FROM ros:foxy

SHELL ["/bin/bash", "-c"]

# dependencies
RUN apt-get update --fix-missing && \
apt-get install -y git \
nano \
vim \
python3-pip \
libeigen3-dev \
tmux \
ros-foxy-rviz2
RUN apt-get -y dist-upgrade
RUN pip3 install transforms3d

# f1tenth gym
RUN git clone https://github.com/f1tenth/f1tenth_gym
RUN cd f1tenth_gym && \
pip3 install -e .

# ros2 gym bridge
RUN mkdir -p sim_ws/src/f1tenth_gym_ros
COPY . /sim_ws/src/f1tenth_gym_ros
RUN source /opt/ros/foxy/setup.bash && \
cd sim_ws/ && \
apt-get update --fix-missing && \
rosdep install -i --from-path src --rosdistro foxy -y && \
colcon build

WORKDIR '/sim_ws'
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh
ENTRYPOINT ["./entrypoint.sh"]
CMD ["/bin/bash"]

问题原因与修复方案 #

核心问题1：路径拼写错误 #

entrypoint.sh中/opt/ors/foxy/setup.bash是笔误，正确路径应为/opt/ros/foxy/setup.bash，这是导致环境变量未加载的直接原因之一。

核心问题2：环境变量的继承逻辑 #

ENTRYPOINT脚本中的source仅在当前脚本进程生效，若启动的是新bash进程（如CMD指定的/bin/bash），子进程不会自动继承这些环境变量。针对无头场景，推荐以下两种可靠方案：

方案1：将source命令写入bashrc（永久生效）

修改entrypoint.sh，把ROS环境配置写入容器的bashrc文件，确保任何新启动的bash进程都会自动加载：

#!/bin/bash
# 写入全局bashrc或用户bashrc
echo "source /opt/ros/foxy/setup.bash" >> /root/.bashrc
echo "source /sim_ws/install/local_setup.bash" >> /root/.bashrc
# 执行传入的命令
exec "$@"

方案2：用绝对路径source并确保子进程继承

修复路径拼写，同时用绝对路径指向local_setup.bash（避免WORKDIR变化导致路径失效）：

#!/bin/bash
source /opt/ros/foxy/setup.bash
source /sim_ws/install/local_setup.bash
exec "$@"

启动容器时，直接用docker run -it your-image，进入bash后可通过echo $ROS_DISTRO验证是否输出foxy，确认环境变量已加载。

方案3：直接在Dockerfile中配置bashrc

跳过entrypoint脚本，直接在Dockerfile的构建阶段写入bashrc：

# 在colcon build步骤后添加
RUN echo "source /opt/ros/foxy/setup.bash" >> /root/.bashrc
RUN echo "source /sim_ws/install/local_setup.bash" >> /root/.bashrc

此方式无需依赖entrypoint，适合无头场景下的自动执行需求。

验证方法 #

构建镜像并启动容器：

docker build -t f1tenth-ros .
docker run -it f1tenth-ros

在容器内执行echo $ROS_VERSION，若输出2则说明基础ROS环境已加载；执行echo $PYTHONPATH，若包含/sim_ws/install/lib/python3.8/site-packages则说明工作空间配置生效。

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