carlesfernandez/docker-gnsssdr Docker 镜像 - 轩辕镜像

docker-gnsssdr

本仓库包含一个Dockerfile，用于创建一个安装了GNSS-SDR及其依赖项（通过.deb包）的Docker镜像。其中包括GNU Radio以及通过UHD、gr-osmosdr和gr-iio支持的多种射频前端驱动。

该镜像基于baseimage-docker构建，这是一个专为Docker容器优化的特殊镜像。它以Ubuntu为基础，并具有以下特点：

• 针对Docker友好性的修改
• 在Docker环境中特别有用的管理工具
• 便于运行多进程的机制，同时不违反Docker理念
• 减少内存占用

如果尚未安装Docker，请先安装Docker并验证安装，然后再继续使用或构建此Docker镜像。

拉取Docker镜像

您可以通过以下命令下载（拉取）镜像：

$ docker pull carlesfernandez/docker-gnsssdr

运行Docker镜像

运行命令：

$ docker run -it carlesfernandez/docker-gnsssdr

带主机文件夹访问权限运行

您可能需要将包含GNSS原始数据的本地文件夹挂载到容器中进行处理，或提取容器运行时生成的输出文件。可通过以下命令运行容器：

$ docker run -it -v /home/user/data:/data carlesfernandez/docker-gnsssdr

这会将主机的/home/user/data文件夹挂载到容器内的/data文件夹，并具有读写权限。

带图形环境运行

• 在GNU/Linux主机上

  在主机上安装X11服务器工具：

  • Debian: apt-get install x11-xserver-utils
  • Ubuntu: apt-get install x11-xserver-utils
  • Arch Linux: pacman -S xorg-xhost
  • Kali Linux: apt-get install x11-xserver-utils
  • CentOS: yum install xorg-xhost
  • Fedora: dnf install xorg-xhost
  • Raspbian: apt-get install x11-xserver-utils

  每次需要使用图形环境时，在主机上调整X服务器权限：

  $ xhost +local:root
  

  然后运行容器：

  $ sudo docker run -e DISPLAY=$DISPLAY -v $HOME/.Xauthority:/root/.Xauthority \
  --net=host -it carlesfernandez/docker-gnsssdr
  

  如需撤销已授予的权限：

  $ xhost -local:root
  

• 在macOS主机上

  一次性设置：

  • 安装最新版XQuartz并运行
  • 在XQuartz设置中激活"允许来自网络客户端的连接"选项
  • 退出并重启XQuartz以激活设置

  每次需要使用图形环境时（确保XQuartz已运行），在主机中输入：

  $ xhost + 127.0.0.1
  

  然后运行容器：

  $ docker run -e DISPLAY=host.docker.internal:0 -v $HOME/.Xauthority:/root/.Xauthority \
  --net=host -it carlesfernandez/docker-gnsssdr
  

• 测试一下！

  在容器中运行：

  root@ubuntu:/home# gnuradio-companion
  

构建Docker镜像

如果已拉取镜像，则无需此步骤。如果需要自行构建更新的Docker镜像，请进入仓库根目录并运行以下命令：

 $ docker build -t carlesfernandez/docker-gnsssdr .

您可以根据需要修改标签名carlesfernandez/docker-gnsssdr。

版权和许可

版权所有：© 2017-2021 Carles Fernández-Prades，CTTC。保留所有权利。

本仓库内容以MIT许可证发布。

致谢

本工作部分得到西班牙科学、创新和大学部通过"大维度通信系统的统计学习与推理（ARISTIDES，RTI2018-099722-B-I00）"项目的支持。