coppit/xeoma

docker-xeoma

这是一个运行Xeoma的Docker容器，Xeoma是由Felena Soft开发的监控软件。它支持多种安防摄像头，CPU占用极低，且拥有非常易用的界面。该容器仅包含服务器，不包含用户界面。可在任何计算机或移动设备上运行客户端，通过8090端口连接服务器。您也可以配置Xeoma的摄像头以在Web界面中显示，Web界面通过***端口访问。

此Docker镜像可在https://hub.docker.com/r/coppit/xeoma/%E8%8E%B7%E5%8F%96%E3%80%82

您可以使用软件的试用版体验Xeoma，准备就绪后再购买。但请注意试用版的限制——设置不会保存，存档视频在1小时后会被删除。避免使用免费版，因其无法连接到您的容器。请务必阅读最终用户许可协议(EULA)，运行此Docker容器即表示您同意该协议。

运行

您可以使用环境变量或配置文件来配置此容器。使用环境变量的命令如下：

bash
docker run -d --name=Xeoma -p 8090:8090 -p 10090:10090 -v /local/path/to/config:/config -v /local/path/to/archive:/archive -e VERSION='latest' -e PASSWORD='<password>' coppit/xeoma

若要创建模板配置文件，请运行：

bash
docker run -d --name=Xeoma -p 8090:8090 -p 10090:10090 -v /local/path/to/config:/config -v /local/path/to/archive:/archive coppit/xeoma

首次运行时，配置目录中会创建一个名为xeoma.conf的文件，容器随后会退出。编辑此文件，设置客户端密码，如需运行不同版本的Xeoma，可修改VERSION（见下文）。然后重新运行上述命令。

存档文件夹用于存储保存的视频录像。

要访问您的Xeoma服务器，只需从Xeoma官网下载相同版本的软件，并将其设置为使用Docker主机的IP地址和您选择的密码连接到远程服务器。

注意：若要开放***端口供Web服务器使用，您需要将Web服务器至少添加到一个摄像头上。否则，通过浏览器访问网页时会收到“404 Not Found”错误。

有关摄像头相关的特殊网络注意事项和许可问题，请参见下文说明。

使用以下命令查看日志：

bash
docker logs xeoma

使用存档缓存

您可以选择一个文件夹作为录像文件的临时存储，待录像完全录制后再移动到存档文件夹。使用此参数可显著减少磁盘碎片。这对于大量摄像头或主存档使用SSD的情况非常有用。

要使用此功能，只需在运行容器时添加额外选项：-v /local/path/to/archive-cache:/archive-cache。

选择版本

VERSION环境变量可用于选择Xeoma的版本。取值可以是“latest”、“latest_beta”、版本字符串（如“17.5.5”），或以“[***]

启动过程中，所需版本会根据需要下载到配置目录的“downloads”子目录中。该目录中所有匹配xeoma_*.tgz模式的文件将被删除。随后会自动安装该版本。

警告：默认情况下，Xeoma会在启动时自动检测新版本并更新。您应在用户界面中禁用此功能，转而依赖容器的版本管理。如果您使用特定版本的软件，这将防止容器重启时Xeoma自动更新。如果您使用“latest”版本，容器本身会自动更新（即使无需重启）。

注意事项

许可与Docker容器

许可机制的具体运作方式尚不完全明确。自16.12.26版本起，Lite版禁止在虚拟机中运行。这是否（以及如何）适用于Docker容器尚不明确。您的容器可能还需要持续联网以验证许可。

注册软件时，许可将存储在您的配置目录中。因此，许可会随容器更新保留，您在应用中进行的任何配置更改也会保留。但如果您删除了配置目录，可能需要联系Felena Soft获取新的注册密钥。

安装许可前，请谨慎选择网络设置。如果您已在主机网络或桥接网络模式下注册软件，切换到另一种网络模式可能会导致错误。您仍可以切换回原模式。

不过，若遇到任何问题，容器每次启动时会在macs.txt文件中追加一些MAC地址相关信息。如果许可无法正常工作，可尝试在docker run命令中使用--mac-address标志，强制新容器使用与旧容器相同的MAC地址。此方法仅在使用桥接网络时有效。

或者，如果您在Kubernetes中运行且无法设置MAC地址，可在容器环境变量或xeoma.conf文件中设置MAC_ADDRESS变量。容器会在启动时设置自己的MAC地址。

最后，若所有方法均失败，请通过felenasoft网站获取帮助。

发现摄像头

根据您的安防摄像头的工作方式，您可能需要通过添加--net=host到运行命令来启用主机网络模式。如果您使用IP摄像头，可以在更安全的桥接网络模式下运行此容器。但此时您需要手动输入摄像头的URL，因为摄像头搜索功能可能无法工作。您可以参考此网站获取有关rtsp:// URL的信息，以访问摄像头的低质量和高质量视频流。

支持

如果您发现与Docker容器相关的软件错误，请告知我，我会进行调查。如果发现与软件本身或摄像头等相关的错误，请联系FelenaSoft。

致谢

此Docker容器最初基于https://github.com/jedimonkey/xeoma-docker%E5%BC%80%E5%8F%91%E3%80%82

感谢GitHub用户https://github.com/skylord123%E6%8F%90%E4%BE%9B%E7%9A%84%E5%85%B3%E4%BA%8E%E7%89%88%E6%9C%AC%E7%AE%A1%E7%90%86%E7%9A%84%E5%87%BA%E8%89%B2%E5%BB%BA%E8%AE%AE%E3%80%82