carlesfernandez/docker-gnsssdr

docker-gnsssdr

本仓库包含一个Dockerfile，用于创建一个安装了GNSS-SDR及其依赖项（通过.deb包）的Docker镜像。其中包括GNU Radio以及通过https://github.com/EttusResearch/uhd%E3%80%81gr-osmosdr%E5%92%8Chttps://github.com/analogdevicesinc/gr-iio%E6%94%AF%E6%8C%81%E7%9A%84%E5%A4%9A%E7%A7%8D%E5%B0%84%E9%A2%91%E5%89%8D%E7%AB%AF%E9%A9%B1%E5%8A%A8%E3%80%82

该镜像基于https://github.com/phusion/baseimage-docker%E6%9E%84%E5%BB%BA%EF%BC%8C%E8%BF%99%E6%98%AF%E4%B8%80%E4%B8%AA%E4%B8%93%E4%B8%BADocker%E5%AE%B9%E5%99%A8%E4%BC%98%E5%8C%96%E7%9A%84%E7%89%B9%E6%AE%8A%E9%95%9C%E5%83%8F%E3%80%82%E5%AE%83%E4%BB%A5Ubuntu%E4%B8%BA%E5%9F%BA%E7%A1%80%EF%BC%8C%E5%B9%B6%E5%85%B7%E6%9C%89%E4%BB%A5%E4%B8%8B%E7%89%B9%E7%82%B9%EF%BC%9A

• 针对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）"项目的支持。