hilschernetpi/netpi-raspbian

Raspbian

https://img.shields.io/badge/License-MIT-yellow.svg](https://opensource.org/licenses/MIT) https://images.microbadger.com/badges/commit/hilschernetpi/netpi-raspbian.svg](https://microbadger.com/images/hilschernetpi//netpi-raspbian "Raspbian") https://img.shields.io/docker/pulls/hilschernetpi/netpi-raspbian.svg](https://registry.hub.docker.com/r/hilschernetpi/netpi-raspbian/)  https://img.shields.io/badge/dynamic/json.svg?url=https://api.microbadger.com/v1/images/hilschernetpi/netpi-raspbian&label=Image%20last%20updated&query=$.LastUpdated&colorB=007ec6](http://microbadger.com/images/hilschernetpi/netpi-raspbian "Image last updated") 

专为树莓派3B架构设备及兼容设备设计

镜像概述

本镜像部署了基于Debian的容器，包含SSH服务器、Raspbian OS预装的预编译软件包（含userland工具）及默认用户pi，适用于树莓派3B/4B、netPI等设备的嵌入式开发与运行场景。

核心功能

• 基于Debian基础镜像，启用SSH服务
• 包含Raspbian Lite操作系统的预装包（无头模式）
• 创建默认用户pi，支持标准Linux命令操作
• 支持蓝牙功能（需特权模式及设备映射）
• 兼容userland工具（如vcmailbox），需特权模式及设备映射

使用场景

• 树莓派设备的嵌入式应用开发与测试
• 物联网（IoT）设备的轻量级运行环境
• 基于Raspbian的自动化脚本执行
• netPI等工业级嵌入式设备的应用部署

配置说明

环境变量（可选）

• SSHPORT：自定义SSH端口，默认值为22

网络模式

• 桥接模式：需映射主机未使用端口到容器端口（22或SSHPORT），不支持蓝牙功能
• 主机模式：自动暴露容器端口，支持蓝牙功能（需特权模式）

特权模式（可选）

启用后可解除Docker容器限制，支持蓝牙及userland工具功能

主机设备映射（可选）

• 蓝牙功能：需映射/dev/ttyAMA0和/dev/vcio
• userland工具：需映射/dev/vcio、/dev/vchiq、/dev/vc-mem

部署示例

netPI部署步骤

1. 打开netPI的Web UI（HTTPS）
2. 进入Portainer.io Docker管理界面
3. 添加容器时设置以下参数：

   参数	值	说明
   镜像	hilschernetpi/netpi-raspbian	可添加标签（如:latest）
   网络	bridge/host	选择桥接或主机模式
   主机名	raspberrypi	可选，模拟Raspbian默认主机名
   重启策略	always	确保容器自动重启
   环境变量	SSHPORT=自定义端口	可选
   端口映射	主机端口→容器22/SSHPORT	仅桥接模式需设置
   设备映射	/dev/ttyAMA0:/dev/ttyAMA0	蓝牙功能需添加
   设备映射	/dev/vcio:/dev/vcio	蓝牙/用户工具需添加
   设备映射	/dev/vchiq:/dev/vchiq	用户工具需添加
   设备映射	/dev/vc-mem:/dev/vc-mem	用户工具需添加
   特权模式	开启	蓝牙/用户工具需开启

4. 点击部署容器

Docker命令行示例

bash
docker run -d --privileged --network=host --restart=always -e SSHPORT=22 --device=/dev/ttyAMA0:/dev/ttyAMA0 --device=/dev/vcio:/dev/vcio --device=/dev/vchiq:/dev/vchiq --device=/dev/vc-mem:/dev/vc-mem -p 22:22/tcp docker.xuanyuan.run/hilschernetpi/netpi-raspbian

Docker Compose示例

yaml
version: "2"
services:
  raspbian:
    image: docker.xuanyuan.run/hilschernetpi/netpi-raspbian
    restart: always
    privileged: true
    network_mode: host
    ports:
      - 22:22
    devices:
      - "/dev/ttyAMA0:/dev/ttyAMA0"
      - "/dev/vcio:/dev/vcio"
      - "/dev/vchiq:/dev/vchiq"
      - "/dev/vc-mem:/dev/vc-mem"
    environment:
      - SSHPORT=22

容器访问

容器部署后自动启动SSH服务，使用SSH客户端（如Putty）连接主机IP，端口为22或自定义SSHPORT，用户名pi，密码raspberry，即可执行标准Linux命令。

许可证

本镜像基于MIT许可证，详情见项目源码仓库的LICENSE.txt文件。镜像中包含的第三方软件（如Bash等）遵循各自的许可证，用户需确保使用符合相关许可要求。

![Hilscher Logo]([]
Hilscher Gesellschaft fuer Systemautomation mbH | []