WebUI项目：如何实现无界面模式的本地Web服务器

2025-06-22 22:29:02作者：柏廷章Berta

概述

WebUI是一个轻量级的跨平台库，它允许开发者使用现代Web技术构建本地应用程序界面。在某些场景下，开发者可能希望仅运行Web服务器而不显示原生窗口，直接通过浏览器访问本地服务。本文将详细介绍如何在WebUI项目中实现这一功能。

无界面模式实现方法

WebUI提供了NoBrowser参数来实现无界面模式。开发者可以通过以下方式使用：

#include <webui.hpp>

int main() {
    webui::window myWindow;
    myWindow.show_browser(
        "<html><script src=\"webui.js\"></script>Hello World</html>", 
        NoBrowser);
    webui::wait();
    return 0;
}

获取服务器地址信息

在无界面模式下运行时，开发者可以通过get_url()方法获取当前Web服务器运行的地址和端口信息：

std::string server_url = myWindow.get_url();

这个方法返回一个包含主机地址和端口的字符串，格式为"HOST:PORT"。

应用场景

后台服务：当应用程序需要作为后台服务运行时，不需要显示任何界面
远程访问：开发者可以通过网络中的其他设备访问本地服务
自动化测试：在自动化测试环境中运行Web服务而不需要实际界面
嵌入式系统：在资源有限的设备上运行轻量级Web服务

注意事项

确保系统防火墙允许对应端口的访问
在生产环境中应考虑添加适当的安全措施
无界面模式下需要确保有方法可以正常终止服务
端口冲突时WebUI会自动尝试其他端口

总结

WebUI的无界面模式为开发者提供了灵活的部署选项，使得基于Web技术的本地应用可以适应更多样化的使用场景。通过简单的API调用，开发者可以快速搭建本地Web服务，并通过浏览器进行访问，同时避免了原生窗口的开销。

webui

Use any web browser as GUI, with your preferred language in the backend and HTML5 in the frontend, all in a lightweight portable lib.

项目地址：https://gitcode.com/gh_mirrors/we/webui

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。

336

178

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

Ascend Extension for PyTorch

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

Java

agent-studio

openJiuwen agent-studio提供零码、低码可视化开发和工作流编排，模型、知识库、插件等各资源管理能力

本仓将收集和展示高质量的仓颉示例代码，欢迎大家投稿，让全世界看到您的妙趣设计，也让更多人通过您的编码理解和喜爱仓颉语言。