User Tools

Site Tools


zh-cn:doc:start

文档

这是OpenWrt Wiki的文档区域,如果你想要捐助我们的话请读这里Wiki Maintainers.
这里以表格的形式列出了支持的设备.
老的OpenWrt手册可以在这里找到。

配置OpenWrt

Recipes

Recipes是指这些用来解释常见的类似路由客户端模式配置这样的OpenWrt设置情况的文章。

页面 描述
3g/UMTS dongle 通过USB插SIM卡的方式使用3G/UMTS做为WAN连接
Bridged AP 如何在AP模式中桥接无线和有线以太网
Routed AP 如何将无线和有线以太网放入不同的子网中
Client Mode 关于无线客户端模式的泛泛之论
Routed Client 如何配置一个路由式的或者伪装式(masqueraded)的无线客户端
Bridged Client (Broadcom) 如何通过专有的Broadcom驱动来设置一个无线客户端网桥
WDS (Broadcom) 如何通过专有的Broadcom驱动来设置AP-to-AP WDS
WDS (Atheros) 如何通过madwifimac80211驱动来设置AP-to-Sta WDS
Multi-SSID 如何设置多个虚拟接入点
Guest WLAN 如何为你的访客设置一个WLAN
Dumb AP 将你的路由作为一个纯接入点,没有路由转发,没有DHCP,什么都没有

HOWTOs

HOWTOs 涵盖OpenWrt额外可能支持的任务。例如,设置一个打印服务器,使用vanilla,通过opkg安装包并初始配置。如果你想要对此作出贡献的话请使用这个模板

目录 页面 描述
基本 Howtos
新手 基本Howtos 基础入门知识
新手 基础配置 新手的帮助指南,老手的复习材料
Overviews
network 做为服务器 概述中概述:提供网络服务
network 做为客户端 概述中的概述:使用网络上提供的服务
administer WebUIs Web用户界面相关的文章(概述)
administer 统计 收集统计数据(概述)
sys 日志概述 与日志相关的文章(概述)
network Web服务器概述 Http服务相关文章(概述)
network 代理服务其概述 代理服务器相关文章 (概述)
network 无线 无线相关的文章 (概述)
network IPv6 IPv6 相关的文章 (概述)
network E-Mail概述 E-Mail 相关的文章 (概述)
network 更多internet服务 If you have Double Play/Triple Play/Quadruple Play
network VoIP 一切有关 VoIP 的文章
network IPTV 一切有关 IPTV 的文章
periphery USB 概述 USB相关文章 (概述)
periphery 印表机 使用openwrt提供印表机共享服务
other 数据库 设置 Database management systems 比如 MySQL, PostgreSQL, …
security 证书 证书的验证与帮助
security VPN 概述 在使用VPN方面的概述
新手 基本认识 帮助新手了解他们的系统
文章分类
network cable上网/DSL上网 怎样通过 Cable-/DSL-Modem上网
network 配置 Motorola cable modem 怎样去配置你的Motorola cable modem (DOCSIS)
network 流量控制 数据包调度, QoS, 流量控制, 通过优先级
network Netfilter Packet filter, firewall, iptables, ip6tables, ebtables, arptables
sys 带宽监控 怎么跟踪带宽使用情况
sys Obtain Firmware Four ways to obtain a Firmware-Image-File
network Dynamic DNS Create a domain name that points to your IP
network Define a DMZ Separate a switch port and make it a DMZ
sys EAD Installing and using the Emergency Access Daemon
sys Extroot Using external storage as root filesystem
sys Kexec Boot a kernel from internal flash and then execute another kernel on external storage
periphery I2C over USB Using USB-I2C adapters on OpenWrt
network NFS Server Howto setup a Network File System (NFS) server on OpenWrt
PulseAudio Since trunk 2011-01 we can install PulseAudio
NetBoot NetBoot
虚拟化 Qemu Running OpenWrt in Qemu
虚拟化 VirtualBox Running OpenWrt in VirtualBox
虚拟化 VMWare Running OpenWrt in VMWare
虚拟化 Xen Running OpenWrt in Xen
security wget Certificates Installing SSL certificates for wget
security Mini-Httpd & SSL How to get mini-httpd and SSL working
sys Hardware Buttons Make the Hardware Buttons toggle events
network UDP multicast IPTV / UDP multicast
util BoxBackup Running BoxBackup on OpenWrt
external links.external.howtos Not everything can be in this wiki
network Connect by L2TP Connect to ISP using L2TP with Dual Access

UCI configuration

OpenWrts central configuration is located in the /etc/config/ directory.

The abbreviation UCI stands for Unified Configuration Interface and is intended to centralize the configuration of OpenWrt.

Configuration should be easy and straightforward, making life easier! UCI is all about that. It is the successor to the NVRAM-based configuration found in the White Russian series of OpenWrt. UCI can be seen as OpenWrt's main configuration user interface for the most important system settings. Typically, these are settings that are crucial for the functioning of the device, such as are typically found in the web interface of routers and embedded devices; that is, functionality that is integrated in the system builds. Examples are the main network interface configuration, wireless settings, logging functionality and remote access configuration.

In addition, selected third party programs have been made compatible with the UCI system, so these can be managed more easily as well. Many programs have their own configuration files lying around somewhere, like /etc/network/interfaces, /etc/exports, /etc/dnsmasq.conf or /etc/samba/smb.conf and they often use different syntaxes. With OpenWrt, you don't have to bother with any of them and need to change only the UCI configuration file(s). Of course, most of the software that you would like to install will not have been prepared for UCI configuration, which is a good thing, because oftentimes you will want the full power of an application's own configuration interface, as it was intended by the developers. Therefore, only a few selected programs which benefit from availability of a centralised configuration have been made UCI-compatible by the OpenWrt package maintainers (see the UCI configuration file list below).

Most applications (save some that are made in-house) are made UCI-compatible by the package maintainer by simply writing the original configuration file (which is read by the program) according to the chosen settings in the corresponding UCI file. This is done upon running the initialization scripts in /etc/init.d/. See Init scripts for more information. Thus, when starting a daemon with such a UCI-compatible initialization script, you should be aware that the program's original configuration file gets overwritten. For example, in the case of Samba/CIFS, the file /etc/samba/smb.conf is overwritten with UCI settings from the UCI configuration file /etc/config/samba when running /etc/init.d/samba start. In addition, the application's configuration file is often stored in RAM instead of in flash, because it does not need to be stored in non-volatile memory and it is rewritten after every change, based on the UCI file. There are ways to disable UCI in case you want to adjust settings in the original configuration file not available through UCI. FIXME add the recommended way please, or link to it.

For those non-UCI compatible programs, there is a convenient list of some non-UCI configuration files you may want to tend to. Note that, for most third party programs, you should consult the program's own documentation.

→ Read more...

Building

These articles focus on compiling OpenWrt sources.

Page Description
OpenWrt Buildroot — About About OpenWrt Buildroot
Buildroot Setting up an OpenWrt build system
Build Using the build system to compile OpenWrt
Build VM Using the build system to compile OpenWrt within a virtual machine
Feeds Working with package feeds
Image Generator The Image Generator (aka Image builder) lets you create custom images without having to compile or setting up a build system
SDK Using the SDK to compile package sources

Build HOWTOs

Build-HowTos include doing things from scratch and then using the Build System to obtain an own firmware (see template_howtobuild):

Page Description
Netgear WNDR3700 Build the Netgear WNDR3700 firmware
Seagate Dockstar Build the Seagate Dockstar firmware
TP-Link TL-MR3420 Build the TP-Link TL-MR3420 firmware
3G-Dongle Build firmware including UMTS-Modem support
Vanilla About the packages in the vanilla firmware
single package Compile and package only one single package

Developing

Documentation of specific development related tasks.

Page Description
Hacking
First Steps First Steps on an unsupported device
Add a platform General considerations for adding new platform support
Add a device Howto add support for a new device
Kernel stuff
isa Stuff related to the ARCH
drivers Stuff related to drivers
OpenWrt
Debugging On Debugging
Build environments Manage different configurations and files in a single Buildroot
Software Libraries What libraries you could use
Crosscompile Cross compile sources into binaries without packaging them
Packages Packaging software
Feeds Working with package feeds
Dependencies Using dependencies for packages
Patches Adding, modifying and refreshing patches
Bugs Reporting and tracking bugs
UCI-Lua Lua bindings for UCI
Config scripting Using UCI configuration files in shell scripts
Network scripting Network scripting and protocol handler API
GNU Debugger Howto use the GNU Debugger
Eclipse IDE Howto use the Eclipse IDE including GNU Debugger

Technical references

Articles covering background information and technical description of various OpenWrt components.

Page Description
Utilities
OPKG OPKG package manager reference
mtd mtd utility reference
sysupgrade sysupgrade script
UCI UCI reference
LuCI LuCI reference (Homepage)
Functioning
Flash Layout How data is stored on the flash
Filesystems About the different file systems
The Bootloader About Booloaders
启动 关于启动程序
Init Scripts Init script implementation reference
Preinit Preinit, Mount Root, and First Boot Scripts
Block Mount Block Device Mounting
Hotplug Hotplug
Boot & Init Requirements What the new init system needs to do to be feature complete compared to current, and goals for improvement
General
Build System Technical Reference for OpenWrt Buildroot
Internal device network Explanation of the internal device network
Brcm63xx Imagetag Information on the firmware image format for brcm63xx
TRX vs TRX2 vs BIN Information on the different file types
External Documentation Links to external documentation

Frequently Asked Questions (FAQ)

zh-cn/doc/start.txt · Last modified: 2014/04/03 03:47 (external edit)